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2. 2. 3. 2 


inl_Iaser.c 

(./simnet/release/src/vehicle/m  1  /src/m  1  _laser.c  [ m  1  _laser.c] ) 


Includes: 

"stdio.h" 

"sim_types.h" 

"sim_dfns.h" 

"sim_macros.h" 

''mass_stdc.h’‘ 

"dgi_stdg.h" 

"sim_cig_if.h" 

"pro_data.h" 

"libproc.h" 

"libhull.h" 

"libkin.h" 

"libturret.h" 

"libmsg.h" 

"libfaiLh" 

"failure.h" 

"mljaser.h" 

"ml_bcs.h" 

"ml.cntrl.h" 

"ml_elecsys.h" 

"ml_firecU.h" 


Defines: 

Symbol  Value 

PROBABILITY_OF_MULTIPLE_RETURNS  0.1 
LRF_OFF  1 

LRF  SAFE  2 

lrfZarmed_first_return  3 

LRF_ARMED_LAST_RETURN  4 


int  declarations  and  initialization: 
lrf_debug  =  0 

use_dazder_laser  =  FALSE 
lrf_state 

number_of_lasings 

lase_times[3] 

BOOLEAN  declarations: 
its_dead_Jim 
multiple_retums 


REAL  declarations: 

value_ftom_cig 
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2. 2. 3. 2.1  laser  init 


This  routine  initializes  the  laser  system. 


1  Internal  Variables  I 

Internal  Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard 

Calls 

Function 

Where  Described 

firecti  laser  malfunction  rese 
t 

Section  2.2.2  2.3.4 

fail  init  failure 

Section  2.5.4.11.2 

Table  2.2-73:  laser  init  Information. 


2. 2. 3. 2. 2  lasershowstatus 

This  routine  prints  status  information  for  the  laser  system. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

s 

pointer  to  char 

Standard 

1  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

i 

int 

Standard 

Table  2.2-74:  laser  show  status  Information. 


2. 2. 3. 2. 3  laser_lrf_failure 

This  routine  causes  the  laser  range  finder  to  fail. 


1  Calls  1 

Function 

Where  Described 

firecti  laser  malfunction  set 

Section  2.2.2.2.3  3 

Table  2.2-75:  laser_lrf_failure  Information. 
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I 


Table  2.2-76:  laser_repair_lrf  Information. 
2. 2. 3. 2. 5  laser_power_off 


This  routine  shuts  the  laser  power  off. 


1  Errors  I 

Error  Name 

Reason  for  Error 

laser_power_off():  unknown 
state 

The  variable  lrf_state  has  an  unexpected  value. 

Calls 

Function 

Where  Described 

laser  show  status 

Section  2.2.3.2.2 

Table  2.2-77:  laser_power_off  Information. 


2. 2. 3. 2. 6  laser  select  safe 


This  routine  puts  the  laser  into  the  LRF_SAFE  state. 


1  Errors  I 

Error  Name 

Reason  for  Error 

laser_select_safe():unknown 

state 

The  variable  lrt_state  has  an  unexpected  value. 

Calls 

Function 

Where  Described 

laser  show  status 

Section  2.2.3.2.2 

firecti  laser  malfunction  rese 
t 

Section  2. 2. 2. 2.3.4 

Table  2.2-78:  laser  select  safe  Information. 


2. 2. 3. 2. 4  laser_repair_lrf 


This  routine  repairs  the  laser  range  finder. 


1  Calls  1 

Function 

Where  Described 

laser  init 

Section  2. 2.3.2. 1 

laser  show  status 

Section  2. 2. 3. 2. 2 
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2 . 2 . 3 . 2 . 7  Iaser_select_first_return 

This  routine  puts  the  laser  into  the  LRF_ARMED_FIRST_RETURN  state. 


1  Errors  1 

Error  Name 

Reason  for  Error 

laser_selectj  irst_retum() ; 
unknown  state 

The  variable  lrt_state  has  an  unexpected  value. 

Calls 

Function 

Where  Described 

laser  show  status 

Section  2  2.3.2.2 

Table  2.2-79:  laser  select  first  return  Information. 


2. 2. 3. 2. 8  laser  select  last  return 


This  routine  puts  the  laser  into  the  LRF_ARMED_LAST_RETURN  state. 


1  Errors  I 

Error  Name 

Reason  for  Error 

laser_selectjasl_relurn() : 
unknown  state 

The  variable  lrf_stale  has  an  unexpected  value. 

Calls 

Function 

Where  Described 

laser  show  status 

Section  2.2.3.2  2 

Table  2.2-80:  laser  select  last  return  Information. 


2. 2. 3. 2. 9  laser_power_up_safe 

This  routine  powers  up  the  laser  and  puts  it  into  the  LRF_SAFE  state  if  it  is  off.  Otherwise,  a 
status  message  is  printed. 


1  Errors  I 

Error  Name 

Reason  for  Error 

laser_power_up_safe() : 
unknown  state 

The  variable  lrf_state  has  an  unexpected  value. 

Calls 

Function 

Where  Described 

laser  show  status 

Section  2.2  3.2.2 

Table  2.2-81:  laser  power  up  safe  Information. 
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2.2.3.2.10  Iaser_power_up_fi rst_return 

This  routine  powers  up  the  laser  and  puts  it  into  the  LRF_SAFE  state  if  it  is  off.  Otherwise,  a 
status  message  is  printed. 


1  Errors  I 

Error  Name 

Reason  for  Error 

laserj3ower_up_firsl_return() 
:unknown  state 

The  variable  lrf_slate  has  an  unexpected  value. 

Calls 

Function 

Where  Described 

laser  init 

Section  2.2. 3. 2.1 

firecti  laser  malfunction  set 

Section  2. 2. 2. 2.3.3 

laser  show  status 

Section  2. 2. 3.2. 2 

Table  2.2-82:  Iaser_power_up_first_return  Information. 


2.2.3.2.11  laser_power_up_last_return 


This  routine  powers  up  the  laser  and  puts  it  into  the  LRF_SAFE  state  if  it  is  off.  Otherwise,  a 
status  message  is  printed. 


1  Errors  I 

Error  Name 

Reason  for  Error 

lase  r_powe  r_up_last_retu  rn( ) : 
unknown  state 

The  variable  lrf_state  has  an  unexpected  value. 

Calls 

Function 

Where  Described 

laser  init 

Section  2. 2.3.2. 1 

firecti  laser  malfunction  set 

Section  2.2.2.2.3.3 

laser  show  status 

Section  2. 2.3. 2.2 

Table  2.2-83:  laser_power_up_last_return  Information. 
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2.2.3.2.12  time_n_lases_ago 

This  routine  returns  the  time  n  lases  ago. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

n 

int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

MAXINT 

int 

n  >  number  of  lasings 

timers_get  tick()  - 

lase  timet.  .^\ 

int 

n  <=  number_ofJasings 

Calls 

Function 

Where  Described 

timers  qet  current  tick 

Section  2, 6.3. 1.1 

Table  2.2-84:  tiine_n_lases_ago  Information. 


2.2.3.2.13  record_this_lase 

This  rouitne  records  the  time  of  the  current  lase. 


1  Calls  1 

Function 

Where  Described 

timers  get  current  tick 

Section  2. 6.3. 1.1 

i 


Table  2.2-85:  record  this  lase  Information. 
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2.2.3.2.14  laser_perforiii_lase 

This  routine  will  attempt  a  lase.  It  returns  TRUE  if  it  tried  to  lase  for  range,  regardless  of 
success  or  failure.  It  returns  FALSE  if  it  tried  to  dazzle. 


1  Internal  Variables  1 

Internal  Variable 

Tvoe 

Where  Typedef  Declared 

tempfSl 

REAL 

sim  types. h 

lased  pt 

VECTOR 

Sim  types. h 

target  id 

TargetDescriptor 

Calls 

Function 

Where  Described 

electsys  laser  start  request 

Section  2.2.6.3.1.10 

time  n  lases  ago 

Section  2.2.3.2.12 

network  send  laser  range 

Section  2.1.1.3.1.29.1 

laser  show  status 

Section  2.2.3.2.2 

record  this  lase 

Section  2.2.3.2.13 

roll  dice 

Sim  macros.h 

cig  laser  range 

Section  2.1.2.2.3.4.1 

vec  mat  mul 

Section  2.6.2.56.1 

kinematics  get  h  to  w 

Section  2.5.8. 1.2 

vec  add 

Section  2.6.2.57.1 

kinematics  get  o  to  h 

Section  2. 5.8. 1.4 

bcs  .  range  is 

Section  2.2.3.1.11 

Table  2.2-86:  laser_perform_lase  Information. 


2.2.3.2.15  laser_lase 

This  routine  is  an  external  call  to  attempt  a  lase. 


1  Errors  I 

Error  Name 

Reason  for  Error 

PANIC;  laserjase:  laser  in 
bad  state:  ... 

The  variable  lrf_state  has  an  unexpected  value. 

Calls 

Function 

Where  Described 

laser  show  status 

Section  2. 2. 3. 2.2 

laser  perform  lase 

Section  2.2.3.2.14 

Table  2.2-87:  laser  lase  Information. 
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2.2.3.2.16  Iaser_multiple_retu  rns 

This  routine  returns  multiple _returns. 


1  Return  Values  1 

Return  Value 

Type 

Meanina 

multiple  returns 

BOOLEAN 

Normal  end. 

Table  2.2-88;  laser  inultiple_returns  Information. 


2.2.3.2.17  laser_ready_to_fire 

This  routine  returns  FALSE  if  the  laser  is  dead  or  the  Irf  is  off  and  returns  TRUE  otherwise. 


1  Return  Values  1 

Return  Value 

Meanina 

FALSE 

BOOLEAN 

The  laser  is  dead  or  the  Irt  is 
off. 

TRUE 

BOOLEAN 

The  laser  is  alive  and  the  Irf  is 
on. 

Table  2.2-89:  laser_ready_to_fire  Information. 


2.2.3.2.18  laser  last  return 


This  routine  returns  TRUE  if  Irf  state  equals  LRF_ARMED_LAST_RETURN  and  returns 
FALSE  otherwise. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

TRUE 

BOOLEAN 

Irf  state  ==  LRF  ARMED 

LAST  RETURN 

FALSE 

BOOLEAN 

Irf  state  !=  LRF  ARMED 

LAST  RETURN 

Table  2.2-90:  laser  last  return  Information. 

2.2.3.2.19  laserrange 

This  routine  returns  the  laser  range  from  the  CIG. 


1  Return  Values  i 

Return  Value 

Type 

Meaning 

value  from  ciq 

REAL 

the  laser  range. 

Table  2.2-91:  laser  range  Information. 
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2.2.3.2.20  laser  fire  fontrol  malfunction 

This  routine  causes  the  laser  i.  control  to  fail. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

its  dead  Jim 

BOOLEAN 

The  laser  fire  control  has  failed 

Table  2.2-92: 


laser  fire  control  malfunction  Information. 
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2. 2. 3. 3  inl_weapons.c 

(./simnet/rclease/src/vehicle/ml/src/ml_weapons.c  [m  l_weapons.c]) 

This  is  the  gunnery  simulation  module.  Code  for  ballistics  simulation  is  contained  in  this  file. 

Includes: 

"stdio.h" 

"math.h" 

”sim_types.h" 

"sim_dfns.h" 

"sim_macros.h" 

"basic.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"libevent.h" 

"libmatrix.h" 

"libimps.h" 

"libsusp.h" 

"libkin.h" 

"libhull.h" 

"libnetwork.h" 

"libturret.h" 

"libsound.h" 

"libball.h" 

"libmath.h" 

"libmap.h" 

"mun_type.h" 

"ml_ammo.h" 

"ml_ammo_df.h" 

"ml_cntrl.h" 

"ml_sound_dfn.h" 

"ml_turret.h" 

"ml_firectl.h" 

"ml_bcs.h" 

"ml_cig.h" 

"mljaser.h" 

"ml_weapons.h" 

The  following  art  defined: 

(jUN_MAIN 
GUN.SAFE 
GUN_COAX 
MAX_DGI_RANGE 
GUN_LENGTH 
GUN_HEIGHT 
RAD_STD_DEV 
WEAPONS_EMPTY 
F.FreCl'_OFFSET 


meters 
meters 
meters 
0.3  mils 

offect  in  meters  for  origin  of  effect 


Ifie  following  variables  are  declared; 
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pser_heanbeat 

ammo_type_loaded,  animo_type_in_flight 
main_gun..firing_status,  round_id 
fire_position,  fire_delta_position 
fire_gun_to_world 
null_vehicleID 


2. 2. 3. 3.1  weapons_download_balIistics_tabIes 

This  routine  downloads  the  ballistics  tables  for  the  HEAT  and  SABOT  rounds. 


1  Variables  | 

Internal  Variable 

Where  Typedef  Declared 

using  assvmetric 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

ballistics  load  trajectory  file 

Section  2.5.2.3.1 

Table  2.2*93:  weapons_dow'nload_baliistics_tabIes  Information. 


2. 2. 3. 3. 2  weapons_init 

This  routine  initializes  the  weapons  system..  The  main  gun  firing  status  is  set  to  WORKING, 
and  the  ammo  type  loaded  is  set  to  WEAPONS_EMPTY. 


1  InternaiVariables  | 

Internal  Variable 

Type 

Where  Typedef  Declared 

time  temp 

long 

Standard 

Calls 

Function 

Where  Described 

ballistics  load  trajectory  file 

Section  2. 5.2.3. 1 

Table  2.2-94:  weaponsjnit  Information. 


2. 2. 3. 3. 3  weapons_simul 

This  routine  is  not  used  in  the  Version  6.6  release. 


2 . 2 . 3 . 3 . 4  weapons_disable_main_gun 

This  routine  disables  the  main  gun  by  setting  the  main  gun  firing  status  to  BROKEN. 

2. 2. 3. 3. 5  weapons_repair_main_gun 
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This  routine  repairs  the  main  gun  by  setting  the  main  gun  firing  status  to  WORKING. 
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2. 2. 3. 3. 6  weapons_fire_main_gun 

This  is  an  event-driven  function,  used  to  fire  the  main  gun.  A  sound  fired  message  is 
generated  and  sent  to  the  CIG.  The  CIG  uses  the  downloaded  ballistic  tables  to  paint  the 
picture  of  the  round  as  it  flies  out. 


Internal  Variables  | 

Internal  Variable 

Where  Typedef  Declared 

scaled  normal 

VECTOR 

Sim  types. h 

Qun  muzzle 

VECTOR 

sim  types. h 

bias  vector 

VECTOR 

Sim  types. h 

VECTOR 

sim  types. h 

f  aun-velocitvfSl 

float 

Standard 

intersection  check  time 

REAL 

sim  types. h 

Calls  1 

Function 

Where  Described 

map_get_ammo_entry_from_ 
network  type 

Section  2.6.11.2.1 

ammo_tvpe  loaded  quick 

Section  2.2.5.1.25 

firecti  ready  to  fire 

Section  2. 2. 2.2.3 

ammo  qun  fired 

Section  2.2.5.1.31 

controls  qun  fired 

Section  2.2.2 

vec  scale 

Section  2.6.2.64.1 

kinematics  qet  u  norm 

Section  2.5.8. 1.5 

vec  add 

Section  2.6.2.57.1 

kinematics  qet  o  to  h 

Section  2. 5.8. 1.4 

kinematics  qet  d  pos 

Section  2.5. 8. 1.7 

bivariant  normal  distribution 

Section  2. 6. 1.1.1 

turret  qet  qun  to  world 

Section  2.2.6.1.1.36 

event  qet  eventid 

Section  2. 6.9. 1.2 

map_get_tracer_from_ammo_ 

entry 

Section  2.6.11.2.9 

ballistics  fire  a  round 

Section  2.5.2. 2.1 

vec  init 

Section  2.6.2.61.1 

vec  mat  mul 

Section  2.6.2.56.1 

impacts  queue  effect 

Section  2.5.15.1.3 

network  send  shell  fire  pkt 

Section  2.1.1.3.1.57.1 

laser  ranqe 

Section  2. 2.3.2 

turret  qet  turret  slew  rate 

Section  2. 2.6. 1.1. 5 

bcs  qet  ammo  type 

Section  2.2.3.2 

suspension  qun  fired 

Section  2. 5. 6. 1.1 

turret  to  hull  cos 

turret  _to  hull  sin 

sound,  make  const  sound 

Section  2. 1.3. 1.2 

Table  2.2-95:  weapons_fire_main_gun  Information. 
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2.2.4  Ml  Failures 

Failure  generation  in  SIMNET  allows  the  introduction  of  simulated  physical  failures  and 
degradations  of  a  vehicle's  capabilities.  This  involves  the  generation  of  a  variety  of  different 
kinds  of  failures  and  the  presentation  of  these  failures  to  either  the  crew  of  a  manned  simulator, 
or  the  operator  of  a  computer  controlled  vehicle.  Failures  are  divided  into  categories  that 
indicate  the  method  used  for  failure  generation.  The  three  categories  are  combat  damage, 
stochastic  failure,  and  deterministic  failure. 


Combat  Damage 

During  combat  a  vehicle  receives  combat  information  messages  from  the  network.  This 
information  comes  in  two  different  forms.  First,  impact  message  tells  the  vehicle  that  someone 
has  been  hit  by  an  incoming  direct  fire  round  or  missile  (both  referred  to  as  a  round).  If  the 
round  struck  another  vehicle,  then  the  message  is  ignored  for  purposes  of  combat  damage. 

The  vehicle  stmck  by  the  round  uses  the  information  in  the  message  to  calculate  any  damages 
that  may  result.  Second,  an  indirect  fire  message  tells  the  vehicle  that  an  indirect  fire  round  has 
exploded  The  impact  point  is  checked  to  determine  if  the  impact  was  close  enough  to  damage 
the  vehicle. 


Stochastic  Failures 

A  stochastic  failure  occurs  when  a  vehicle  fails  on  its  own  and  not  because  of  a  crew  error  or 
due  to  com.bat  damage.  The  frequency  of  failure  is  determined  by  a  Mean  Number  of 
Operations  Between  Failures  (MNOBF).  Stochastic  failures  can  degrade  functions  or  can 
serve  as  a  warning  for  potential  deterministic  failures. 


Deterministic  Failures 

Deterministic  failures  are  those  failures  which  result  from  some  improper  action  by  the  crew 
that  generally  could  have  been  prevented.  These  include  both  failures  due  to  resource  depletion 
and  failures  due  to  crew  error.  Examples  of  these  errors  include  mismanaging  fuel  and 
ammunition,  ignoring  warning  lights,  and  throwing  a  track  while  driving  the  vehicle  across  a 
hill  with  too  great  a  slope. 
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Figure  2.2-5:  Structure  of  the  Ml  Failures  CSC. 

Simulation  of  these  failure  modes  is  accomplished  with  the  following  CSU's: 

ml_failure.c 

ml_repair.c 
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2.2.4. 1  ml_f»;Hure.c 

(./simnet/re?iease/src/vehicle/m  1/src/m  1  _failure.c  [m  1  _failure  .c] ) 

The  Ml  specific  failures  functions  are  performed  by  this  CSU. 

m2_failure,;c 

m2_repair.'C 

Includes; 


stdio.h" 

"bigwheel.h" 

math.h" 

"libsound.h" 

'sim.typesr-h" 

"libmain.h" 

'sim_dfns„h" 

"librva.h" 

’sim.macros.h" 

"libevent-h" 

'pro.sim.h" 

"ml.rep.map.h" 

'mun.type  .h" 

"ml  sound  dfn.h 

'pro_data.h" 

"libhull.h" 

'mass.stdc.h" 

"librepair.h" 

'dgi_stdg.h\" 

"libnetwork.h" 

'sim  cig_i:i‘.h" 

"repair.ml.h" 

’libfail.h" 

"status.ml.h" 

’failure.h" 

"status.h" 

'  NUM.SUB  .SYSTEMS 
MOB.ELECTRICAL.SUBSYS 
ENGINE.SUBSYS 
TRANSMJZSSION.SUBSYS 
MOB.OTITER.SUBSYS 
FIRE.COt^TTROL.SUBSYS 
GUN.TUISIRET.SUBSYS 
ACTUAL_NUM_LEVELS 
USED.NIJM.LEVELS 
MAINT.lL.l.MMBF 
MAINT_L_2_MMBF 
MAINT_L_3_MMBF 
MAINT.L  _4_MMBF 
MAINT_L_5_MMBF 

Declarations: 

MAINT_LiEVFI._ARRAY 
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2.2.4. 1.1  fail  init 


This  routine  initializes  the  failures  system.  The  combat  failures  and  combat  failure  table  are 
initialized,  and  the  stochastic  failures  and  stochastic  damages  table  are  initialized.  The  repairs 
are  initialized  and  the  collision  damages  are  initialized. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

fialure  collision  damages 

int 

Standard 

Calls 

Function 

Where  Described 

failure  collision  damages 

Section  2.2.4. 1.8 

cfail  init 

Section  2. 5.4.5. 1 

fail  table  init 

Section  2.5.4.11.1 

sfail  init 

Section  2.5.4.23.1 

get  sdamage  file 

Section  2.5. 1.2. 7 

{repair  init 

Section  2.5.14.5.1 

collision  init 

Section  2.5.10.5.1 

Table  2.2-97:  fail  init  Information. 


2.2.4. 1.2  failure  mob  electrical  fixed 


This  routine  is  called  by  the  repairs  code  when  the  alternator,  pilot  relay,  or  staner  is  fixed. 


1  Calls  1 

Function 

Where  Described 

sfail  fixed  good  as  new 

Section  2.5.4.22.1 

Table  2.2-98:  failure  mob  electrical  fixed  Information. 


2.2.4. 1.3  failure_engine_fixed 


This  routine  is  called  by  the  repairs  code  when  the  engine  oil  filter,  oil  level,  or  major 
component  is  repaired  or  replaced. 


1  Calls  1 

Function 

Where  Described 

sfail  fixed  good  as  new 

Section  2.5.4.22.1 

Table  2.2-99:  failure_engine_fixed  Information. 
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2.2.4. 1.4  failure  transmission  fixed 


This  routine  is  called  by  the  repairs  code  when  the  transmission  oil  filter,  oil  level,  or  shifting 
assembly  is  repaired  or  replaced 


Function 


stall  fixed  aood  as  new 


Calls 


Where  Described 


Section  2.5.4.22.1 


Table  2.2-100:  failure_transmission_rixed  Information. 

2.2.4. 1.5  faiIure_fuel_or_brakes_fixed 

This  routine  is  called  by  the  repairs  code  when  the  fuel  pump,  fuel  filter,  service  brake,  or 
parking  brake  is  repaired. 


Function 


stall  fixed  qood  as  new 


Calls 


Where  Described 


Section  2.5.4.22.1 


Table  2.2-101:  failure_fuel_or_brakes_fixed  Information. 

2 . 2 . 4 . 1 . 6  failu  re_fire_con  trol_fixed 

This  routine  is  called  by  the  repairs  code  when  the  Laser  Range  Finder,  Gunner's  Primary 
Sight,  or  Gunner's  Primary  Sight  Extension  is  fixed. 


Calls 

Function 

Where  Described 

stall  fixed  aood  as  new 

Section  2.5.4.22.1 

Table  2.2-102:  failure_fire_control_fixed  Information. 
2.2.4. 1.7  failure_gun_turret_fixed 

This  routine  is  called  by  the  repairs  code  when  the  Gun/Turret  Drive/Stab  is  fixed. 


Function 


stall  fixed  aood  as  new 


Calls 


Where  Described 


Section  2.5.4.22.1 


Table  2.2-103:  failure_gun_turret_rixed  Information. 
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2 . 2 . 4 . 1 . 8  failure_collision_damages 

This  routine  is  called  by  the  collision  code  when  a  collision  is  detected.  Parameters  are 
represented  as  follows; 

direction  -  The  direction  the  collision  came  from:  RIGHT_WHEEL, 

LEFT.WHEEL,  or  REAR_WHEEL,  as  defined  in 
/simnet/vehicleAibbigwh/bigwh_loc.h 

cause  -  The  cause  of  the  collision,  cause  can  be  either  a  hash  id  corresponding 

to  the  vehicle  collided  with  or  -2  (signifying  a  ground  collision) 
event  Jd  -  The  event  id  corresponding  to  the  collision 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

direction 

int 

Standard 

cause 

int 

Standard 

event  id 

lonq  int 

Standard 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

temp  failures 

pointer  to  lonq 

Standard 

vid 

pointer  to  VehiclelD 

basic. h 

Return  Values 

Return  Value 

Type 

Meanlnq 

0 

int 

damaqe  detected 

Calls 

Function 

Where  Described 

sound  make  const  sound 

Section  2. 1.3. 1.2 

rva  pet  veh  id 

Section  2.5.12.10.1 

turret  collision  detected 

Section  2.2.6.1.1.32 

network  send  outta  my  way  mf 

Section  2. 1.1. 3. 1.8.1 

Table  2.2-104:  failure_collision_damages  Information. 
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2.2.4. 1.9  failure_check_cat_kill 

This  routine  checks  to  see  if  a  direct  impact  packet  came  from  a  rriine.  If  the  packet  is  from  a 

mine,  then  the  tank  is  destroyed.  If  the  packet  is  not  from  a  mine,  the  blast  door  is  open,  and 

the  caliber  of  the  round  is  greater  than  50mm,  then  the  tank  is  automatically  destroyed. 

Otherwise,  damages  are  calculated  by  calling  cfail_dir_fire_damages()  in  libfail. 

Parameters  are  represented  as  follows: 

ammo  type  --  the  ammo  indix  from  libmap 

hitjnsg  —  pointer  to  the  Impact  Variant  PDU 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

hit  msQ 

pointer  to  ImpactVariant 

p  sim.h 

ammo  type 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

ammo  blast  door  open 

Section  2.2.5.1.43 

fail  vehicle  is  destroyed 

Section  2.5.4.9.2 

cfail  dir  fire  damages 

Section  2.5.4.3.1 

Table  2.2-105:  failure_check_cat_kill  Information. 

2.3.4.1.10  failure_check_indi r_fire_damages 

This  routine  checks  to  see  if  an  indirect  impact  packet  came  from  a  mine.  If  the  packet  is  from 
a  mine  and  the  detonation  occurs  within  10  meters  of  the  tank,  then  the  tank  is  destroyed.  If 
the  packet  is  not  from  a  mine,  then  damages  are  calculated  by  calling 
cfaiMndirect_fire_damages()  in  libfail.  Parameters  are  represented  as  follows: 
ammo  type  --  the  ammo  indix  from  libmap 

indir  Jire  msg  -  pointer  to  the  indirect  fire  variant  PDU 

r  squared  -  The  range  from  the  detonation  to  the  vehicle 

detonation  rum  -  The  detonation  number  within  the  Indirect  Fire  Variant  PDU 


Parameters  1 

Parameter 

Where  Typedef  Declared 

ammo  type 

int 

Standard 

indir  fire  msq 

pointer  to  IndirectFireVariant 

p_  sim.h 

r  squared 

REAL 

Sim  types. h 

detonation  num 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

fail  vehicle  is  destroyed 

Section  2. 5.4.9. 2 

cfaiijndirectjire  damages 

Section  2. 5.4.3. 1 

kinematics  get  h  to  o 

Section  2. 5. 8. 1.3 

kinematics  get  w  to  h 

Section  2.5.8. 1.1 

Table  2.2-106:  failure_check_indir_fire_damages  Information. 
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2. 2. 4. 2  nil_repair.c 

(./simn^release/src/vehicle/m  1/src/ml  _repair.c  [m  1  _rcpair.c] ) 

The  Ml  specific  repairs  functions  are  performed  by  this  CSU. 

Includes: 

"stdio.h" 

"sim_dfns.h" 

"sim_macros.h" 

"sim_types.h" 

"pro_assoc.h" 

"mass_stdc.h" 

"dgLstdg.h" 

"sim_cigjf.h" 

Defines: 

QUIET 
REQUEST 

MAX_REPAIR_ENTmES 

Declarations: 

repair_vehicle 
repair_vehicles_near_hear 
num_repair_velucles 
repair_state 
repair_timer_id 
clear_repair_vehicles() 
repair_quietjstate() 
repair”requ^t_state() 
send_feed_me3acl^ets_repair_vehicles() 


"pro_data.h" 

"pro_sim.h" 

"repair_ml  .h" 

"timers_dfn.h" 

"timers.h" 

"libnetwork.h" 

"ml.cntrl.h" 

"ml_resupp.h" 
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2. 1.4. 2.1  repair_request 


Thi&'troutine  processes  repair  requests  that  come  in  over  the  network  from  the  Admin/Log 
consrale  of  the  MCC.  The  MCC  host  times  these  repairs  and  informs  the  simulator  that  the 
repair  is  complete  via  a  network  message. 


1  Parameters  I 

Paraimeter 

Type 

Where  Typedef  Declared 

event 

int 

Standard 

aaertr 

pointer  to  VehiclelD 

basic. h 

code 

int 

Standard 

oriainator 

pointer  to  SimulationAddress 

address,  h 

tid 

T  ransactionidentifier 

p  assoc. h 

Errors 

Error 

Reason  for  Error 

stderr,  ’REPAIR:  repair  requestO 

unknown  repair  state 

Calls 

Function 

Where  Described 

timers  free  timer 

Section  2. 6.3. 5.1 

repair  system  is  fixed 

Section  2.5.4.19.4 

send  repaired  pkt 

Section  2.1.1.3.1.38.1 

Table  2.2-107:  repair_request  Information. 


2. 2. 4. 2. 2  repair_simul 


This  routine  runs  the  repair  simulation  and  is  responsible  for  all  self-repairs  to  the  simulation 
The  routine  checks  the  vehicle's  repair  state  and  calls  the  appropriate  routine  for  that  state. 


1  Errors  I 

Error 

Reason  for  Error 

stderr,  REPAIR;  repair  simuK) 

unknown  repair  state 

Calls 

Function 

Where  Described 

repair  quiet  state 

Section  2. 2. 4. 2. 7 

repair'  request  state 

Section  2. 2.4. 2.8 

clear  repair  vehicles 

Section  2.2.4.2.4 

Table  2.2-108:  repair_simul  Information. 
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2. 2. 4. 2. 3  repair_init 

This  routine  initializes  the  repair  simulation.  All  repair  vehicles  are  cleared,  the  repair  state  is 
set  to  QUIET,  and  the  repair  timer  is  set  to  NULL_TIMER. 


1  Calls  i 

Function 

Where  Described 

clear  repair  vehicles 

Section  2. 2.4. 2. 4 

Table  2.2-109:  repair  init  Information. 


2. 2. 4. 2. 4  clear_repair_vehicles 

This  routine  clears  the  repair _vehicles  near _here  flag  to  FALSE  and  the  number  of  repair 
vehicles  to  zero. 

2. 2. 4. 2. 5  repair_near_repair 

This  routine  maintains  the  list  of  close  vehicles  which  are  repair  vehicles.  If  any  repair  vehicles 
are  on  this  list,  the  repair _vehicles  near  Jiere  flag  is  set  to  TRUE. 


1  Parameters  1 

Parameter 

Type_ 

Where  Typedef  Declared 

V 

pointer  to  VehiclelD 

basic.h 

Table  2.2-110:  repair_near_repair  Information. 

2 . 2 .4 . 2 . 6  send_feed_me_packets_repair_vehicles 

This  routine  sends  a  repair  request  packet  to  each  of  the  repair  vehicles  on  the  network. 


Internal 

Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard 

Calls 

Function 

Where  Described 

network  send  feed  me  packet 

2. 1.1.3  .48.1 

Table  2.2-111:  send_feed_me_packets_repair_vehicles  Information. 
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2. 2. 4. 2. 7  repair_quiet_state 

This  routine  determines  the  vehicle's  repair  Finite  State  Machine's  QUIET  state.  If  the 
following  conditions  are  BOTH  TRUE: 

•  The  resupply  gating  conditions  are  TRUE  (the  vehicle  is  alive,  the  vehicle  is  not 
moving,  and  no  controls  failures  exist). 

•  There  are  repair  vehicles  nearby. 

Then,  send  a  feed  me  packet  to  the  repair  vehicles  on  the  network,  start  the  repair  timer,  and 
enter  the  REQUEST  state.  If  any  of  the  conditions  are  not  met,  remain  in  the  QUIET  state. 


1  Return  Values  1 

Return  Value 

Type 

Meanina 

QUIET 

int 

in  QUIET  state 

REQUEST 

int 

in  REQUEST  state 

Calls 

1  Function 

Where  Described 

Section  2.2.5.3.15 

timers  aet  timer 

Section  2. 6.3. 6.1 

send  feed  me  packets  repair  vehicles 

Section  2. 2.4. 2. 6 

Table  2.2-112:  repair^quiet  state  Information. 


2. 2. 4. 2. 8  repair_request_state 


This  routine  determines  the  vehicle's  repair  Finite  State  Machine's  REQUEST  state.  If 
EITHER  of  the  following  conditions  are  TRUE: 

•  The  resupply  gating  conditions  are  FALSE  (the  vehicle  is  dead,  the  vehicle  is 
moving,  or  a  controls  failure  exists). 

•  There  are  no  fuel  carriers  nearby. 

Then,  free  the  repair  timer  and  enter  the  QUIET  state.  If  none  of  the  conditions  are  met  and  the 
resupply  timer  has  expired,  send  another  service  request,  restart  the  timer,  and  remain  in  the 
REQUEST  state.  If  the  resupply  timer  has  not  expired,  remain  in  the  REQUEST  state. 


I  Return  Values  I 

Return  Value 

Type 

Meanlrq 

QUIET 

int 

in  QUIET  state 

REQUEST 

int 

in  REQUEST  state 

1  Calls  1 

1  Function  1 

Where  Described 

Section  2.2.5.3.15 

timers  qet  timer 

Section  2. 6. 3. 6.1 

send  feed  me  packets  repair  vehicles 

Section  2. 2.4. 2. 6 

Table  2.2-113:  repair  request  state  Information. 
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2. 2. 4. 2. 9 


prlnt_repair_status 


This  routine  prints  the  repair  status  information. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

s 

pointer  to  char 

Standard 

1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard 

Table  2.2-114: 


print_repair_status  Information. 
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2.2.5  Ml  Munitions  Management 


The  simulation  keeps  track  of  fuel  and  ammunition  in  ml_ammo.c  and  ml_fuelsys.c.  The 
fuel  system  can  involve  more  than  one  fuel  tank,  and  the  desired  fuel  transfers  within  a 
vehicle.  The  simulation  must  also  determine  the  states  of  all  munitions  on  board  a  vehicle. 
This  includes  the  availability,  which  ammunitions  are  loaded,  and  which  ammunition  is 
being  fired.  Resupply  of  all  munitions  (fuel  and  ammunition)  is  coordinated  in  the  file 
ml_resupp.c.  These  files  implement  the  functions  necessary  to  resupply  munitions  from 
MCC  vehicles  (hemmits,  etc.)  and  other  vehicle  simulations  (ml  to  ml).  This  functionality 
is  realized  by  the  following  CSU's: 


ml_ammo.c 

ml_fuelsys.c 

ml_resupp.c 
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2.2.5. 1  inl_ammo.c 

(./simnet/release/src/vehicle/ml/src/ml_ammo.c  [ml_ammo.c]) 

This  CSU  keeps  track  of  the  Ml’s  ammunition  supply.  This  file  contains  the  procedures 
relating  to  the  supply,  resupply,  and  loading  of  ammunition.  The  ammo  subsystem  of  the 
Ml  simulation  consists  of  the  loader's  ammo  rack,  the  semi-ready  ammo  rack,  the  hull 
ammo  rack,  the  loader's  knee  switch,  the  loader's  arms,  the  breech,  the  ejection  guard,  and 
the  blast  door. 

Includes: 

"stdio.h" 

"sim_dfns.h" 

"sim_macros.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgLstdg.h" 

"sim_cigjf.h" 

"timers_dfn.h" 

"timers.h" 

"libnetwork.h" 

"libsound.h" 

"ml_ammo.h" 

"ml_ammo_df.h" 

"ml_ammo_mx.h" 

"ml_ammo_pn.h" 

"ml_cntrl.h" 

"ml_ctl_df.h" 

"ml_firectl.h" 

"ml_gunn_mx.h" 

"ml_hydrsys.h" 

"ml_load_mx.h" 

"ml_resupp.h" 

"ml_sound_dfn.h" 

"ml_tmrs_df.h" 

"ml_turr_pn.h" 

"mun_type.h" 

Variable  and  Local  Procedure  Declarations: 

loaders_ready_rack  -  The  loader's  ready  rack  is  viewed  as  an  array  of 

values  which  are  either  munition_US_M456Al, 
munition_US_M392A2,  or  EMPTY 

~  The  next  six  variables  keep  track  of  the  number  of 
rounds  of  each  type. 

hull_apds_quantity 
hulLheat_quantity 
semi_ready_apds_quantity 
semi_ready_heat_quantity 
ready  _apds_qu  antity 
ready  _heat_quantity 

initial_heat_quantity 

initial_apds_quantity 
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The  next  variables  keep  the  status  of  various  subsystems 

ammo_transfer_status 
blast_door_status 
loaders_arms 

breech_ainmo_type 

ejection_guard_status 
autoloader_enabled 

turrct_power_status 
knee_switch_status 
loader_timer_number 
blast_door_timer_number 
resupply_receive_timer_number 
rcsupply_status 
resupply_slot 
resupply_flash_count 
resupply_location 
resupply_send_in_progress 

ammo_open_blast_door() 
ammo”close~bIast_door() 
ainmo”arm_panelJcheck() 
amino~resupply_cTieck() 
animojadd_rouridO 
ammo”subfract_round() 
am  mo~sta  rt_loade  r_t  i  mer  ( ) 
ammo~stop”loader_timer() 
ammo~starr_blast_door_timer() 
ammo_stop_bIast_door_timer() 
ammo_start_resupply_receive_timer() 
ammo_stop_resupply~receive_timer() 
ammo_blast^door_check() 
ammo_resupply_receive_timeout_check() 
ammo_flash  check() 
ammo_startlnternal_resuppIy() 
ammo_change_resupply() 
ammo~decideJjesuppIy_receive() 
ammo_decide_receive_location() 
ammo”decide_resuppIy_send() 
ammo_decide_resupply_sIot() 
ammo_check_autoloader_un!oad() 
ammo_check  autoloader  load() 


-  OPEN  or  CLOSED 

--  munition_US_M456Al,  munition_US_M392A2,  or 
EMPTY 

“  munition_US_M456Al,  munition_US_M392A2,  or 
EMPTY 

--  SAFE  or  ARMED 
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This  routine  initializes  the  ammunition  system  states.  Initial  ammunition  information  is 
provided  by  the  MCC  during  the  activation  sequence. 


1  Calls  1 

Function 

Where  Described 

controls  ejection  quard  safe 

Section  2.2.2 

timers  set  null  timer 

Section  2. 6.3. 1.4.1 

Table  2.2>115:  ammojnit  Information. 

2.2.5. 1.2  ammo_simul 

This  routine  simulates  the  functions  of  the  ammunition  system  on  a  tick  by  tick  basis.  The 
routine  checks  the  status  of  the  blast  door  and  the  status  of  any  internal  or  external 
ammunition  transfers  or  resupplies.  The  routine  monitors  which  gun  is  selected,  and 
coordinates  the  ammunition  types  with  the  ballistics  computer  system  (BCS). 


I  Calls  I 

Function 

Where  Described 

ammo  blast  door  check 

Section  2.2.5.1.51 

ammo  flash  check 

Section  2.2.5.1.52 

ammo  resupply  receive  timeout  check 

Section  2.2.5.1.53 

bcs  get  ammo  type  indexed 

Section  2.2.6.2 

firecti  gun  select  status 

Section  2.2.2.2.3 

ammo  check  autoloader  unload 

Section  2.2.5.1.3 

ammo  check  autoloader  load 

Section  2. 2. 5. 1.4 

Table  2.2-116:  ammo_simul  Information. 

2 . 2 . 5 . 1 . 3  ammo_check_autoloader_unload 

The  autoloader  is  enabled  with  the  command  line  -A  in  order  to  perform  ammo  transfers 
without  a  person  acting  as  loader.  This  routine  unloads  the  breech  and  replaces  the  round 
in  the  ready  rack  when  the  autoloader  is  enabled.  The  routine  checks  to  see  if  the  breech  is 
full.  If  so,  the  ejection  guard  is  opened,  the  blast  door  is  opened,  and  the  breech  round  is 
removed  and  replaced  in  a  slot.. 


1  Calls  1 

Function 

Where  Described 

ammo  ejection  quard  safe 

Section  2.2.5.1.27 

ammo  breech  unload  pushed 

Section  2.2.5.1.24 

ammo  knee  switch  on 

Section  2.2. 5. 1.3 

ammo  tube  selected 

Section  2.2.5.1.11 

ammo  decide  resupply  slot 

Section  2.2.5.1.68 

ammo  knee  switch  off 

Section  2.2.5.1.10 

Table  2.2-117:  ammo_check_autoloader_unload  Information. 
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2. 2. 5. 1.4  ammo  check  autoloader  load 


The  autoloader  is  enabled  with  the  command  line  -A  in  order  to  perform  ammo  transfers 
without  a  person  acting  as  loader.  This  routine  loads  the  breech  when  the  autoloader  is 
enabled.  The  routine  checks  to  see  if  the  breech  is  empty.  If  so,  the  ejection  guard  is 
opened,  the  blast  door  is  opened,  a  round  is  selected  from  the  ready  rack  and  placed  in  the 
breech.  Then,  the  blast  door  is  closed,  the  breech  load  button  is  pushed,  and  the  ejection 
guard  is  armed. 


1  Calls  1 

Function 

Where  Described 

ammo  ejection  guard  safe 

Section  2.2.5.1.27 

ammo  knee  switch  on 

Section  2.2.5.1.3 

bcs  qet  ammo  type  indexed 

Section  2. 2. 6.2 

ammo  tube  selected 

Section  2.2.5.1.11 

ammo  knee  switch  off 

Section  2.2.5.1.10 

ammo  breech  pushed 

Section  2.2.5.1.23 

ammo  election  guard  armed 

Section  2.2.5.1.26 

Table  2.2-118:  ammo  check  autoloader  load  Information. 


2.2.5. 1.5  ammo  init  ammo  racks 


This  routine  initializes  the  quantities  and  types  of  ammo  in  the  ready  rack,  the  semi-ready 
rack,  and  the  hull  rack.  The  routine  checks  to  make  the  ammo  racks  are  not  overloaded, 
and  for  the  ready  rack,  places  the  ammo  into  individual  slots  in  the  ready  rack.  Parameters 
are  represented  as  follows: 


readyjteat 

readyapds 

semi_ready_heat 

semi_ready_apds 

hullheat 

hullapds 


-  The  quantity  of  heat  rounds  to  place  in  the  ready  rack. 

"  The  quantity  of  apds  rounds  to  place  in  the  ready  rack. 

”  The  quantity  of  heat  rounds  to  place  in  the  semi-ready  rack. 

-  The  quantity  of  apds  rounds  to  place  in  the  semi-ready  rack. 
"  The  quantity  of  heat  rounds  to  place  in  the  hull. 

-  The  quantity  of  apds  rounds  to  place  in  the  hull. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

ready  heat 

int 

Standard 

int 

Standard 

semi_  ready  heat 

int 

Standard 

semi  ready  apds 

int 

Standard 

hull  heat 

int 

Standard 

hull  apds 

int 

Standard 

1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

i 

register  int 

Standard 

Table  2.2-119:  ammo  init  ammo  racks  Information. 
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2.2.5. 1.6 


ammo_supply_full 


This  routine  returns  TRUE  if  all  racks  are  full  and  FALSE  if  they  are  not  all  full. 


1  Return  Values  1 

Return  Value 

Meaning 

TRUE 

int 

The  ammo  supply  is  full 

FALSE 

int 

The  ammo  supply  is  not  full 

Table  2.2-120:  ammo_suppIy_fuII  Information. 

2.2.5. 1.7  ammo_supply_empty 

This  routine  returns  TRUE  if  all  racks  are  empty  and  FALSE  if  they  are  not  all  empty. 


1  Return  Values  I 

Return  Value 

Meaning 

TRUE 

int 

The  ammo  supply  is  empty 

FALSE 

int 

The  ammo  supply  is  not  empty 

Table  2.2-121;  ammo_suppIy_empty  Information. 
2.2.5. 1.8  ammo  loaders  arms 


This  routine  returns  the  status  of  the  anmojoadersjirms,  either  filled  with  a  heat  round, 
an  apds  round,  or  EMPTY. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

loaders_arms 

ObjectType 

the  position  of  the 
loaders_arms:  either 
munition_US_M456A1 . 
munition  US  393A2,  or 
EMPTY 

Table  2.2-122:  ammo_supply_full  Information. 
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2.2^.  1.9  ammo_knee_switch_on 

This  rroutine  is  called  when  the  knee  switch  is  hit.  If  the  knee  switch  status  is  OFF,  the 
statoss  is  changed  to  ON  and  the  loader  timer  is  stopped.  Since  the  knee  switch  is  only  used 
for  tnmsfers  to  and  from  the  ready  rack;  the  transfer  status  must  be  NO_TRANSFER_VAL 
for  anything  to  happen. 

If  the  turret  power  is  off  or  in  the  process  of  being  shut  off  (turret _power_status  =  OFF  or 
OFFJEDGE),  hitting  the  kinee  switch  will  have  no  effect.  If  the  turret  power  is  on  or  in  the 
proccsss  of  turning  on  (turret _power  status  =  ON  or  ON_EDGE),  the  blast  door  is  opened 
and  tbie  blast  door  timer  is  stopped. 


1  Errors  1 

Error 

Reason  for  Error 

stderr  AMMO:  ammo  knee  switch  on 

Impossible  amnx)  transfer  status 

Calls 

Function 

Where  Described 

ammO'  stop  loader  timer 

Section  2.2.5.1.48 

hydraatic  ammo  door  open  request 

Section  2.2.6.4.2.7 

ammo  open  blast  door 

Section  2.2.5.1.29 

ammo  stop  blast  door  timer 

Section  2.2.5.1.50 

ammo  start  blast  door  timer 

Section  2.2.5.1.49 

Table  2.2-123:  ammo_knee_switch_on  Information. 


2.2.£'.1.10  ammo_knee_switch_off 

This  ooutine  is  called  when  the  knee  switch  is  released.  If  the  knee  switch  status  is  ON,  the 
status  is  changed  to  OFF  and  the  loader  timer  is  started.  Since  the  knee  switch  is  only  used 
for  trainsfers  to  and  from  the  ready  rack;  the  transfer  status  must  be  NO_TRANSFER_VAL 
for  ajnything  to  happen. 

If  the  iturret  power  is  off  or  in  the  process  of  being  shut  off  (turret _power_status  =  OFF  or 
OFF„EDGE),  releasing  the  knee  switch  will  have  no  effect.  If  the  turret  power  is  on  or  in 
the  piiDcess  of  turning  on  (turret _power  status  =  ON  or  ON_EDGE),  the  blast  door  timer  is 
startead. 


1  Errors  1 

Error 

Reason  for  Error 

stderr  AMMO:  ammo  knee  switch  on 

Impossible  ammo  transfer  status 

Calls 

Function 

Where  Described 

ammo  start  loader  timer 

Section  2.2.5.1.47 

ammo  start  blast  door  timer 

Section  2.2.5.1.49 

Table  2.2-124:  ammo  knee  switch  off  Information. 
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2.2.5.1.11 


ammo  tube  selected 


This  routine  is  called  when  an  ammo  slot  in  the  ready  rack  has  been  selected.  The  slot  is 
specified  by  slot.  If  the  blast  door  is  closed,  it  is  impossible  to  touch  that  ammo  slot  and 
the  routine  does  nothing.  If  the  blast  door  is  open  and  the  transfer  status  is 
NO_TRANSFER_VAL,  the  loader  replaces  the  ammo  into  the  ready  rack; 
ammo_arm_panel_check  is  called.  For  any  other  transfer  status,  then  loader  replaces 
the  amino  into  the  specified  rack;  ammo_resupply_check  is  called. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

slot 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

ammo  arm  panel  check 

Section  2.2.5.1.12 

ammo  resupply  check 

Section  2.2.5.1.13 

Table  2.2-125:  ammo  tube  selected  Information. 


2.2.5.1.12  ammo_arm_panel_check 

This  routine  is  checked  each  tick  of  the  simulation  in  order  to  manage  ammo  in  the  ready 
rack. 


If  the  specified  ready  rack  slot  is  full  and  the  loaders  arms  are  full,  the  routine  does 
nothing.  The  round  contained  in  the  loaders  arms  cannot  be  placed  into  the  full  slot,  and 
the  round  from  the  slot  cannot  be  placed  in  the  loaders  arms. 


If  the  loaders  arms  are  empty  and  the  specified  slot  is  full,  the  round  is  removed  from  the 
slot  and  placed  in  the  loaders  arms.  The  sound  of  tiie  ready  rack  extract  is  made,  the  slot 
status  is  set  to  EMPTY,  and  the  loaders  arms  status  are  set  to  FULL. 


If  the  loaders  arms  are  full  and  the  specified  slot  is  empty,  the  round  taken  from  the  loaders 
arms  and  placed  in  the  slot.  The  correct  sound  of  the  ready  rack  insert  is  made,  the  loaders 
arms  are  set  to  EMPTY,  and  the  slot  status  is  set  to  FULL. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

slot 

int 

Standard 

Calls 

Function 

Where  Described 

controls  unshow  round 

Section  2.2.2 

ammo  subtract  round 

Section  2.2.5.1.42 

sound  make  const  sound 

Section  2.1. 3. 1.2 

controls  show  round 

Section  2.2.2 

ammo  add  round 

Section  2.2.5.1.41 

Table  2.2-126:  ammo_arm_paneI_check  Information. 
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2.2.5.1.13  ammo_resupply_check 


This  routine  is  checked  each  tick  of  the  simulation  in  order  to  manage  the  resupply  of 
ammo.  If  the  loaders  arms  are  full  and  if  the  specified  slot  is  full,  the  loader  cannot 
resupply  ammunition  and  the  routine  does  nothing. 


If  the  loaders  arms  are  empty  and  the  transfer  status  is  equal  to  HULL_HEAT_VAL, 
HULL_APDS_VAL,  SEMI_HEAT_VAL,  or  SEMI_APDS_VAL  and  the  quantity  of  that 
type  in  that  rack  is  greater  than  zero,  then  start  the  internal  resupply  from  the  ammo  type 
and  rack  specified  in  the  transfer  status  to  the  specified  slot. 

If  the  loaders  arms  are  empty  and  the  transfer  status  is  REDIST_RECV_VAL,  then  receive 
the  external  resupply  ammo  type  into  the  slot. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

slot 

int 

Standard 

Calls 

Function 

Where  Described 

ammo  change  resupplv 

Section  2.2.5.1.56 

ammo  start  internal  resupplv 

Section  2.2.5.1.54 

Table  2.2-127: 


ammo_resupply_check  Information. 
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2.2.5.1.14 


ammo_get_quantity 


This  routine  returns  the  quantity  of  the  ammo  in  the  rack  specified  by  the  type  identifier. 


1  Parameters 

1  Parameter  I 

Where  Typedef  Declared 

char 

Standard 

1  Return  Values 

Return  Value 

Meanlnq 

hull_heat_quanity 

int 

The  number  of  heat  rounds  in 
the  hull  rack. 

hull_apds_quanity 

int 

The  number  of  apds  rounds  in 
the  hull  rack. 

semi_ready_heat_quantity 

int 

The  number  of  heat  rounds  in 
the  semi-ready  rack. 

semi_ready_apds_quantity 

int 

The  number  of  apds  rounds  in 
the  semi-ready  rack. 

ready_heat_quantity 

int 

The  number  of  heat  rounds  in 
the  ready  rack. 

ready_apds_quantity 

int 

The  number  of  apds  rounds  in 
the  ready  rack. 

NULL 

int 

error;  impossible  transfer  type 

1  Errors 

Error 

Reason  for  Error 

stderr  AMMO:  ammo  qe;_  Muantity 

impossible  transfer  type 

Table  2.2-128:  ammo_get_quantity  Information. 

2.2.5.1.15  ammo_transfer_semi_heat 

This  routine  starts  the  transfer  of  a  heat  round  from  the  semi-ready  rack  when  the  selector 
on  the  Ammo  Redistribution  Panel  is  placed  in  the  Semi-Ready  Heat  position.  The  transfer 
status  is  changed  to  SEMI_HEAT_VAL,  any  other  resupply  in  progress  is  stopped,  and  the 
blast  door  is  opened. 


1  Calls  1 

■  Function  1 

Where  Described 

Section  2.2.5.1.57 

ammo  open  blast  door 

Section  2.2.5.1.29 

ammo  stop  blast_door  timer 

Section  2.2.5.1.50 

Table  2.2-129:  ammo  transfer  semi  heat  Information. 
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2.2.5.1.16  ammo_transfer_semi_a pds 

This  routine  sa»rts  the  transfer  of  an  apds  round  from  the  semi-ready  rack  when  the  selector 
on  the  Ammo  Redistribution  Panel  is  placed  in  the  Semi-Ready  Sabot  position.  The 
transfer  status  is  changed  to  SEMI_APDS_VAL,  any  other  resupply  in  progress  is 
stopped,  and  tfae  blast  door  is  opened. 


1  Calls  1 

■  Function  1 

Where  Described 

Section  2.2.5.1.57 

ammo  open  bfe.ast  door 

Section  2.2.5.1.29 

ammo  stop  bleest  door  timer 

Section  2.2.5.1.50 

Tatble  2.2-130:  ammo_transfer_semi_apds  Information. 


2.2.5.1.17  ammo_transfer_hulI_heat 

This  routine  sutirts  the  transfer  of  a  heat  round  from  the  hull  rack  when  the  selector  on  the 
Ammo  Redistiiibution  Panel  is  placed  in  the  Hull/Turret  Floor  Heat  position.  The  transfer 
status  is  chan^sd  to  HULL_HEAT_VAL,  any  other  resupply  in  progress  is  stopped,  and 
the  blast  door  is  opened. 


1  Calls  1 

■  Function  1 

Where  Described 

Section  2.2.5.1.57 

ammo  open  bitast  door 

Section  2.2.5.1.29 

ammo  stop  bta'st  door  timer 

Section  2.2.5.1.50 

T;able  2.2-131:  ammo_transfer_hun_heat  Information. 

2.2.5.1.18  .ammo_transfer_hull_apds 

This  routine  stairts  the  transfer  of  an  apds  round  from  the  hull  rack  when  the  selector  on  the 
Ammo  Redistribution  Panel  is  placed  in  the  Hull/Turret  Floor  Sabot  position.  The  transfer 
status  is  chan^d  to  HULL_APDS_VAL,  any  other  resupply  in  progress  is  stopped,  and 
the  blast  door  iis  opened. 


■  Calls  ■ 

■  Function  { 

Where  Described 

Section  2.2.5.1.57 

ammo  open  blast  door 

Section  2.2.5.1.29 

ammo  stop  blast  door  timer 

Section  2.2.5.1.50 

Ta  ble  2.2-132:  ammo_transfer_hull_apds  Information. 
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2.2.5.1.19  ammo_transfer_no_transfer 

This  routine  slops  the  transfer  of  ammo  when  the  selector  on  the  Ammo  Redistribution 
Panel  is  placed  in  the  Off  position.  The  transfer  status  is  changed  to 
NO_TRANSFER_VAL,  any  resupply  in  progress  is  stopped,  and  the  blast  door  timer  is 
started  in  order  to  close  the  blast  door. 


Calls  1 

Function 

Where  Described 

ammo  stop  resupply 

Section  2.2.5.1.57 

ammo  start  blast  door  timer 

Section  2.2.5.1.49 

Table  2.2-133:  ammo_transfer_no_transfer  Information. 
2.2.5.1.20  ammo_transfer_redist_send 

This  routine  initiates  the  sending  of  ammo  to  another  Ml  tank  when  the  selector  on  the 
Ammo  Redistribution  Panel  is  placed  in  the  Ammo  Transfer  Send  position.  The  transfer 
status  is  changed  to  REDIST_SEND_VAL,  any  resupply  in  progress  is  stopped,  and  the 
blast  door  is  opened. 


1  Calls  1 

Function 

Where  Described 

ammo  stop  resupply 

Section  2.2.5.1.57 

ammo  open  blast  door 

Section  2.2.5.1.29 

ammo  stop  blast  door  timer 

Section  2.2.5.1.50 

Table  2.2-134:  ammo_transfer_redist_send  Information. 


2.2.5.1.21  ammo_t  ransferredistrecv 

This  routine  initiates  the  receiving  of  ammo  from  anoil.^r  vehicle  when  the  selector  on  the 
Ammo  Redistribution  Panel  is  placed  in  the  Ammo  Transfer  Rec  position.  The  transfer 
status  is  changed  to  REDIST_RECV_VAL,  any  resupply  in  progress  is  stopped,  and  the 
blast  door  is  opened. 


1  Calls  1 

{Function 

Where  Described 

Section  2.2.5.1.57 

ammo  open  blast  door 

Section  2.2.5.1.29 

ammo  stop  blast  door  timer 

Section  2.2.5.1.50 

Table  2.2-135:  ammo_transfer_redist_recv  Information. 
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2.2.5.1.22  iammo_get_transfer_status 


This  routine  rcnums  the  transfer  status,  which  reflects  the  position  of  the  selector  switch  on 
tlhe  Ammo  Rediistribution  Panel. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

aimmo  transfer  t^iatus 

char 

The  transfer  status. 

Talble  2.2-136:  ammo_get_transfer_status  Information. 
2.2.5.1.25  iammo_breech_pushed 


This  routine  hat.'idles  the  loading  of  the  breech  when  the  red  Breech  Load  button  is  pushed. 
If  the  breech  is  ready,  the  round  is  transferred  from  the  loaders  arms  to  the  breech.  The 
status  of  the  loatiers  arms  is  set  to  EMPTY,  and  the  sound  of  the  breech  closing  is  maae. 


1  Calls  1 

Function 

Where  Described 

ammo  breech  rcsadv 

Section  2.2.5.1.23 

Dontrols  show  breech 

Section  2.2.2 

sound  make  co>nst  sound 

Section  2. 1.3. 1.2 

Table  2.2-137:  ammo_breech_pushed  Information. 


2.2.5.1.24  iBmmo_breech_unload_pushed 


This  routine  handles  the  unloading  of  the  breech  when  the  Breech  Operating  Toggle  Switch 
vs  clicked  down;.  The  loaders  arms  must  be  empty,  the  breech  must  be  loaded,  the  ejection 
guard  must  be  o:pen,  and  the  system  must  not  be  in  resupply  in  order  to  unload  the  breech. 
If  any  of  these  oonditions  are  not  met,  this  routine  does  nothing.  If  the  conditions  are  met, 
the  round  is  traisjsferred  from  the  breech  to  the  loaders  arms.  The  ammo  type  in  the  breech 
Ls  set  to  EMPTY,  and  the  sound  of  the  breech  opening  is  made. 


1  Calls  1 

Function 

Where  Described 

oontrols  show  breech 

Section  2.2.2 

sound  make  ca>.nst  sound 

Section  2. 1.3. 1.2 

Tabbe  2.2-138:  ammo_breech_unIoad_pushed  Information. 
2.2.5.1.25  sammo  type_loaded_quick 

This  routine  retiims  the.  ammo  type  loaded  in  the  breech. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

breerh  ammo_t;ype 

ObjectType 

The  type  of  ammo  in  the 
breech. 

Table  2.^  139: 


ammo  iype  loaded  quick  Information. 
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2.2.5.1.26  ammo_ejection_gua rd_armed 

This  routine  arms  the  ejection  guard,  making  the  closing  sound. 


1  Calls  1 

Function 

Where  Described 

sound  make  const  sound 

Section  2. 1.3. 1.2 

Table  2.2-140:  ammo_ejection_guard_arined  Information. 


I 

I 
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2.2.5.1.27  amino_4ejection_guard_safe 

This  routine  opens  the  (Ejection  guard,  making  the  opening  sound. 


1  Calls  1 

Function 

Where  Described 

sound  make  const  soufrid 

Section  2. 1.3. 1.2 

Table  2.2-141:  ammo_ejection_guard_safe  Information. 
2.2.5.1.28  ammo^ffi j  ection_gua  rd_st atus 
This  routine  returns  tire,  ejection  guard  status. 


I  Return  Values  I 

Return  Value 

Meaning 

ejection_guard_status 

char 

the  status  of  the  ejection 
guard:  either  SAFE  or 

ARMED 

Table  2.2- M 42:  ammo_ejection_guard_status  Information. 
2.2.5.1.29  ammo_open_blast_door 

This  routine  opens  the  fMast  door,  making  the  appropriate  sound.  Each  round  in  the  ready 
rack  is  shown  with  its  9$tot's  light  turned  on,  indicating  the  round  type  (either  Heat  or 
Sabot).  Empty  slots  in  vhs.  ready  rack  will  have  their  lights  turned  off. 


I  Internal  Variables  I 

Variable 

Tvoe 

Where  Typedef  Declared 

i 

register  int 

Standard 

Calls 

Function 

Where  Described 

controls  show  round 

Section  2.2.2 

sound  make_const__sou:'"nd 

Section  2. 1.3. 1.2 

Table  2L.2-143:  ammo_open_blast_door  Information. 
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2.2.5.1.30 


ammo  close  blast  door 


This  routine  opens  the  blast  door,  making  the  appropriate  sound.  All  ready  rack  slot 
indicator  lights  turn  off. 


1  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

i 

register  int 

Standard 

1  Calls  1 

Function 

Where  Described 

controls  unshow  round 

Section  2.2.2 

sound  make  const  sound 

Section  2. 1.3. 1.2 

Table  2.2-144:  ammo_close_blast_door  Information. 
2.2.5.1.31  ammo_gun_fired 

This  routine  empties  the  breech  when  the  gun  is  fired.  The  ammo  type  in  the  breech  is  set 
to  EMPTY. 


1  Calls  1 

Function 

Where  Described 

controls  show  breech 

Section  2.2.2 

Table  2.2-145:  ammo_gun_rired  Information. 


2.2.5.1.32  ammo_ready_to_fire 

This  routine  returns  whether  the  ejection  guard  is  armed  or  safe.  If  the  ejection  guard  is 
armed  and  the  gun  is  ready  to  fire,  the  routine  returns  TRUE;  if  the  ejection  guard  is  safe 
and  the  gun  is  not  ready  to  fire,  the  routine  returns  FALSE. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

ammo_ejectionjguard_ 
statusQ  ==  ARMED 

BOOLEAN 

if  TRUE,  the  ejection  guard  is 
armed  and  the  gun  is  ready 
to  fire; 

if  FALSE,  the  ejection  guard  is 
safe  and  the  gun  is  not 
ready  to  fire. 

Calls 

Function 

Where  Described 

ammo  ejection  guard  status 

2.2.5.1.28 

Table  2.2-146:  ammo_ready_to_fire  Information. 
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l.Jl.5.1.33  ainmo_get_semi_heat_quantity 

Thiis  routine  gets  the  quantity  of  heat  rounds  in  the  semi-ready  rack. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

serra  _ready_heat_quantity 

int 

The  quantity  of  heat  rounds  in 
the  semi-ready  rack 

Table  2.2-147:  ammo_get_seini_heat_quantity  Information. 
2.2.5.1.34  ammo_get_semi_apds_quantity 

This  routine  returns  the  quantity  of  apds  rounds  in  the  semi-ready  rack. 


1  Return  Values  1 

Reborn  Value 

Type 

Meaning 

seiTO_ready_apds_quantity 

int 

The  quantity  of  apds  rounds  in 
the  semi-ready  rack. 

Table  2.2-148:  ammo_get_seml_apds_quantity  Information. 


1.2 .5.1.35  ammo_get_hull_heat_quantity 


Thi;s  routine  returns  the  quantity  of  heat  rounds  in  the  hull  rack. 


1  Return  Values  1 

Ret'jiurn  Value 

Type 

Meaning 

hull...heat_quantity 

int 

The  quantity  of  heat  rounds  in 
the  hull  rack. 

Table  2.2-149:  ammo_get_hull_heat_quantity  Information. 


2. Z .5. 1 .36  ammo_get_hull_apds_quantity 

Thils  routine  returns  the  quantity  of  apds  rounds  in  the  hull  rack. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

hulV_apds_quantity 

int 

The  quantity  of  apds  rounds  in 
the  hull  rack. 

Table  2.2-150:  ammo_get_hull_apds_quantity  Information. 
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2.2.5.1.37  ammo_get_ready_heat_quantity 

This  routine  returns  the  quantity  of  heat  rounds  in  the  ready  rack. 

Return  Values 


Return  Value 

Type 

ready_heat_quantity 

int 

The  quantity  of  heat  rounds  in 
the  ready  rack. 


Table  2.2-151:  amino_get_ready_heat_quantity  Information. 


2.2.5.1.38  ammo_get_ready_a pds_quantity 


This  routine  returns  the  quantity  of  apds  rounds  in  the  ready  rack. 


1  Return  Values  1 

Return  Value 

Type 

Meaninq 

ready_apds_quantity 

int 

The  quantity  of  apds  rounds  in 
the  ready  rack. 

Table  2.2-152:  ammo_get_ready_apds_quantity  Information. 


2.2.5.1.39  ammo_get_heatl05_quantity 

This  routine  gets  the  quantity  of  heat  rounds  in  the  ready  rack,  the  semi-ready  rack,  and  the 
hull  rack  combined. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

ready_heat_quantity  + 
semi_ready_heat_quantity  + 
hull  heat  quantity 

int 

The  total  number  of  heat 
rounds. 

Table  2.2-153:  ammo_get_heatl05_quantity  Information. 


2.2.5.1.40  ammo_get_apdsl05_quantity 

This  routine  gets  the  quantity  of  apds  rounds  in  the  ready  rack,  the  semi-ready  rack,  and  the 
hull  rack  combined. 


1  Return  Values  1 

Return  Value 

Meaning 

ready_apds_quantity  + 
semi_ready_apds_quantity  + 
hull,  apds  quantity 

int 

The  total  number  of  apds 
rounds. 

Table  2.2-154:  ammo_get_apdsl05_quantity  Information. 
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2.2.5.1.41  ainmo_£add_round 

This  routine  increments  die  ready  rack  quantity  of  the  type  of  round  passed  in  round. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

round 

ObiectType 

basic. h 

1  Calls  1 

Function 

Where  Described 

need  to  send  veh  status 

Section  2.1.1.3.1.32.1 

Table  2.2-155:  ammo_add_round  Information. 
2.2.5.1.42  ammojsubtract_round 

This  routine  decrements  the  ready  rack  quantity  of  the  type  of  round  passed  in  round. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

round 

ObiectType 

basic.h 

Calls 

Function 

Where  Described 

need  to  send  veh  status 

Section  2.1.1.3.1.32.1 

Table  ZJ2-156:  ammo  subtract  round  Information. 


2.2.5.1.43  ammo_tolast_door_open 
This  routine  returns  TRUE  if  the  blast  door  is  open. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

TRUE 

char 

the  blast  door  is  open 

FALSE 

char 

the  blast  door  is  closed 

Table  2.2-157:  ammo_blast_door_open  Information. 


2.2.5.1.44  ammo_fturret_power_on 

This  routine  sets  the  turret  power  status  to  ON_EDGE.  When  turret  power  is  turned  on, 
the  turret  power  status  s':?.ys  in  ON_EDGE  until  all  subsystems  are  completely  powered. 

2.2.5.1.45  ammo_a  u r ret  powe  r  off 

This  routine  sets  the  tun*et  power  status  to  OFl*  _EDGE.  When  turret  power  is  turned  off, 
the  turret  power  status  srays  in  OFF..EDGE  until  all  subsystems  are  completely  shut  down. 
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2.2.5.1.46  ainino_breech_ready 

This  routine  determines  if  the  breech  is  ready  to  be  loaded.  The  loader  timer  must  have 
timed  out  this  tick,  the  loaders  arms  must  be  full,  the  breech  must  be  empty,  and  the 
ejection  guard  must  be  open.  If  all  the  conditions  are  met,  the  routine  returns  TRUE. 
Otherwise,  the  routine  returns  FALSE. 


1  Return  Values  1 

Return  Value 

Meaning 

(timers_get_timeout_edge 
(loader_timer_number))  && 
{loaders_arTns!=EMPTY)  && 
(breech  ammo  type  == 
EMPTY)  && 

(ejection_guard  status  == 
SAFE) 

char 

If  all  conditions  are  met,  TRUE 
is  returned,  signifying  that 
the  breech  is  ready  for 
loading; 

If  any  condition  is  not  met, 
FALSE  is  returned, 
signifying  that  the  breech  is 
not  ready  for  loading. 

1  Calls  1 

Function 

Where  Described 

timers_qet  timeout  edqe 

2.6.3.22.1 

Table  2.2-158:  ammo_breech_ready  Information. 


2.2.5.1.47  ammo_startJoader_timer 


This  routine  starts  the  loader  timer.  The  loader  timer  is  set  for  the  minimum  time  it  would 
take  the  loader  to  carry  the  shell.  If  the  loader  timer  was  timing  already,  it  is  restarted  by 
replacing  it  with  a  new  timer  and  freeing  the  old  timer. 


I  Calls  I 

Function 

Where  Described 

timers  free  timer 

Section  2.6.3.5.1 

timers  get  timer 

Section  2. 6.3. 6.1 

Table  2.2-159;  ammo_gun_fired  Information. 


2.2.5.1.48  ammo_stop_loader  timer 


This  routine  stops  the  loader  timer  and  frees  up  its  timer. 


1  Calls  1 

Function 

Where  Described 

timers  free  timer 

Section  2. 6.3.5. 1 

timers  set  null  timer 

Section  2.6.3.14.1 

Table  2.2-160:  ammo_stop_loader_timer  Information. 


2.2.5.1.49  ammo  start  blast  door  timer 
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This  routine  starts  the  blast  door  timer.  The  blast  door  timer  is  set  for  the  amount  of  time 
the  blast  door  stays  open.  If  the  loader  timer  was  timing  already,  it  is  restarted  by  replacing 
it  with  a  new  timer  and  freeing  the  old  timer. 


1  Calls  1 

Function 

Where  Described 

timers  free  timer 

Section  2.6.3.5.1 

timers  aet  timer 

Section  2. 6.3. 6.1 

Table  2.2-161:  ammo  start  blast  door  timer  Information. 


2.2.5.1.50  ammo_stop_blast_door_timer 


This  routine  stops  the  blast  door  timer,  frees  up  its  timer,  and  closes  the  blast  door. 


I  Calls  I 

Function 

Where  Described 

timers  free  timer 

Section  2. 6.3.5. 1 

timers  set  null  timer 

Section  2.6.3.14.1 

Table  2.2-162:  ammo_stop_blast_door_timer  Information. 


2.2.5.1.51  ammo  blast  door  check 


This  routine  checks  the  blast  door  timer  each  tick.  If  the  timer  timed  out,  the  timer  is  freed, 
the  blast  door  is  closed,  and  the  hydraulic  ammo  door  is  closed. 


1  Calls  1 

Function 

Where  Described 

timers  qet  timeout  edqe 

Section  2.6.3.22.1 

timers  free  timer 

Section  2.6.3. 5.1 

timers  set  null  timer 

Section  2.6.3.14.1 

ammo  close  blast  door 

Section  2.2.5.1.30 

hydraulic  ammo  door  closed 

Section  2. 2. 6.4. 2.8 

Table  2.2-163:  ammo  blast  door  check  Information. 


2.2.5.1.52  ammo_flash_check 

This  routine  checks  the  status  of  resupplies  every  tick  for  the  purpose  of  flashing  the 
resupply  lamps.  If  either  a  resupply  receive  timer  is  still  timing,  or  a  resupply  send  is  in 
progress,  the  routine  will  flash  the  resupply  lamps  to  indicate  the  source  and  destination  of 
the  transfer.  When  the  resupply  is  complete,  the  flashing  is  ended. 


1  Calls  1 

Function 

Where  Described 

controls  resupply  flash 

Section  2.2.2 

controls  resupply  unflash 

Section  2.2.2 

Table  2.2-164:  ammo  flash  check  Information. 
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2.2.5.1.53  ainmo_resupply_recei ve_timeout_check 

This  routine  checks  the  status  of  any  resupply  receive  every  tick.  If  the  resupply  receive 
timer  timed  out  this  tick,  the  timer  is  freed.  The  resupply  status  is  checked. 

In  the  case  of  an  internal  resupply,  the  ammo  is  transferred  to  an  empty  ready  rack  slot 
making  the  appropriate  sound.  The  slot's  ammo  lamp  is  turned  on.  "riie  original  location 
of  the  round's  rack  quantity  is  decremented,  and  the  ready  rack  quantity  of  Ae  round  is 
incremented.  The  resupply  status,  location,  and  slot  flags  are  reset,  and  a  vehicle  status 
message  is  sent,  indicating  the  changes  in  ammo  distribution  within  the  tank. 

In  the  case  of  an  external  resupply  receive,  the  appropriate  ammo  type  is  received  in  the 
appropriate  rack,  and  the  rack  quantity  is  incremented.  If  ammo  is  received  in  the  ready 
rack,  the  sound  of  the  ready  rack  insert  is  made  and  the  slot's  ammo  lamp  is  turned  on.  A 
vehicle  status  message  is  sent,  indicating  the  changes  in  ammo  distribution  within  the  tank. 


1  Errors  I 

Error 

Reason  for  Error 

stderr  AMMO:  ammo_resupply_receive_ 
timeout  check 

-  impossible  resupply  location 

-  impossible  resupply  status 

Calls 

Function 

Where  Described 

timers  aet  timeout  edqe 

Section  2.6.3.22.1 

timers  free  timer 

Section  2.6.3.5.1 

timers  set  null  timer 

Section  2.6.3.14.1 

sound  make  const  sound 

Section  2.1. 3. 1.2 

controls  show  round 

Section  2.2.2 

ammo  add  round 

Section  2.2.5.1.41 

controls  resupply  empty 

Section  2.2.2 

need  to  send  veh  status 

Section  2.1.1.3.1.32.1 

controls  resupply  restore 

Section  2.2.2 

resupply  ammo  received 

Section  2.2.5.3.10 

Table  2.2-165:  ammo_resupply_receive_timeout_check  Information. 


2.2.5.1.54  ammo_sta rt_resu pply_receive_timer 

This  routine  starts  the  resupply  receive  timer.  This  timer  is  set  for  the  time  it  takes  to 
transfer  the  ammo  to  the  receiver  in  an  external  resupply.  If  the  resupply  receive  timer  was 
timing  already,  it  is  restarted  by  replacing  it  with  a  new  timer  and  freeing  the  old  timer. 


1  Calls  1 

Function 

Where  Described 

timers  free  timer 

Section  2.6.3.5.1 

timers  qet  timer 

Section  2.6.3.6.1 

Table  2.2-166:  ammo_start_resuppIy_receive_timer  Information. 
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2.2.5.1.55  ammo_stop_resuppIy_recei ve_timer 

This  routine  stops  the  resupply  receive  timer,  freeing  up  the  timer. 


1  Calls  1 

Function 

Where  Described 

timers  free  timer 

Section  2.6.3.5.1 

timers  set  nuii  timer 

Section  2.6.3.14.1 

Table  2.2-167:  ainmo_stop_resupply_receive_timer  Information. 
2.2.5.1.56  ammo_change_resupply 

This  routine  changes  the  resupply  slot  to  slot. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

slot 

int 

Standard 

Calls 

Function 

Where  Described 

controls  resupply  restore 

Section  2.2.2 

Table  2.2-168:  ammo_change_resupply  Information. 
2.2.5.1.57  ammo_stop_resupply 

This  routine  stops  the  resupply.  All  timers  are  stopped,  and  the  resupply  status  and 
resupply  location  are  set  to  NO_TRANSFER_VAL. 


I  Calls  I 

Function 

Where  Described 

ammo  stop  resupply  receive  timer 

Section  2.2.5.1.55 

controls  resupply  restore 

Section  2.2.2 

resupply  stop  ammo  resupply 

Section  2.2.5.30 

Table  2.2-169:  ammo_stop_resupply  Information. 
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2.2.5.1.58 


ammo_start_internal_resuppIy 


This  routine  starts  an  internal  resupply  transfer  of  ammo,  slot  is  the  resupply  slot  which  is 
filled  in  the  transfer. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

slot 

int 

Standard 

Caifs 

Function 

Where  Described 

ammo  start  resupply  receive  timer 

Section  2.2.5.1.54 

controls  resupply  restore 

Section  2.2.2 

Table  2.2-170:  ammo_start_internaI_resuppIy  Information. 
2.2.5.1.59  ammo_sta rt_external_resupply 

This  routine  starts  the  external  resupply  of  ammo.  heat_qffered  and  apds  offered  are  the 
quantities  of  heat  and  apds  rounds  offered  by  the  resupply  sender.  This  routine  calls 
ammo  decide_resupply_receive  in  order  to  determine  the  amount  of  each  ammo  type 
to  receive  and  where  to  place  it.  If  the  desired  location  is  unavailable,  the  routine  returns 
FALSE.  Otherwise,  the  resupply  is  started  and  the  routine  returns  TRUE. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

heat  offered 

int 

Standard 

apds  offered 

int 

Standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

round  location 

char 

Standard 

round  slot 

char 

Standard 

1  Return  Values  I 

Return  Value 

Meanina 

TRUE 

int 

Unsuccessful  resupply;  the 
round  location  is  unavailable. 

FALSE 

int 

Successful  resupply. 

1  Calls  1 

Function 

Where  Described 

ammo  decide  resupply  receive 

Section  2.2.5.1.61 

ammo  start  resupply  timer 

Section  2. 2.5. .1.51 

controls  resupply  restore 

Section  2.2.2 

Table  2.2-171:  ammo_start_external_resupply  Information. 
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2.2.5.1.60  ammo_start_external_send 

This  routine  start  an  external  transfer  send. 


1  Calls  1 

Function 

Where  Described 

controls  resupply  restore 

Section  2.2.2 

Table  2.2-172:  ainnio_start_external_send  Information. 
2.2.5.1.61  ammo_decide_resuppIy_recei  ve 

This  routine  determines  the  quantity  of  each  ammo  type  to  receive  and  where  to  put  it. 
heat  ojfered  and  apds  offered  are  the  quantities  of  heat  and  apds  rounds  offered  by  the 
sender,  location _ptr  is  filled  in  with  the  rack  in  which  to  receive  the  next  round;  slot _ptr  is 
filled  in  with  an  empty  slot  in  which  to  place  the  next  round. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

heat  offered 

int 

Standard 

apds  offered 

int 

Standard 

slot  ptr 

pointer  to  int 

Standard 

location  ptr 

pointer  to  char 

Standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

round  type 

ObiectType 

basic.h 

1  Calls  1 

Function 

Where  Described 

ammo  decide  receive  location 

Section  2.2.5.1.62 

ammo  decide  round  type 

Section  2.2.5.1.63 

Table  2.2-173;  ammo_decide_resupply_receive  Information. 
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2.2.5.1.62  amino_decide_recei ve_location 

This  routine  determines  the  rack  and  slot  in  which  to  put  the  round,  round jype  is  the 
round  to  be  placed;  location _ptr  is  filled  in  with  the  rack  in  which  to  receive  the  round; 
slot _ptr  is  filled  in  with  an  empty  slot  in  which  to  place  the  round 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

round  type 

ObiectType 

basic.. h 

location  ptr 

pointer  to  char 

Standard 

slot  ptr 

pointer  to  int 

Standard 

Calls 

Function 

Where  Described 

ammo  decide  resupply  slot 

Section  2.2.5.1.68 

Table  2.2-174:  ammo_decide_receive_Iocation  Information. 
2.2.5.1.63  ammo_decide_round_type 

This  routine  determines  which  round  type  is  needed  most. 


I  Return  Values  I 

Return  Value 

Type 

Meanina 

munition  US  M456A1 

ObiectType 

Heat  round. 

munition  US  M392A2 

ObiectType 

Apds  round 

Table  2.2-175:  ammo_decide_round_type  Information. 
2.2.5.1.64  ammo_stop_timers 

This  routine  stops  and  frees  all  timers:  the  loader  timer,  the  blast  door  timer,  and  the 
resupply  receive  timer. 


1  Calls  1 

Function 

Where  Described 

timers  free  tiemr 

Section  2. 6.3. 5.1 

timers  set  null  timers 

Section  2.6.3.14.1 

Table  2.2-176: 


ammo_stop_timers  Information. 
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2.2.5.1.65  aiiKino_restore_ammo 

This  routine  restocss  all  ammo.  It  stops  any  resupply  in  progress,  empties  the  loaders 
arms,  empties  the  breech,  and  initializes  the  ammo  racks. 


1  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

i 

1  int  1 

Standard 

1  Calls  1 

Function 

Where  Described 

ammo  stop  resupply 

Section  2.2.5.1.57 

controls  show  bre«ch 

Section  2.2.2 

ammo  init  ammo  r.'scks 

Section  2.2.5. 1.5 

controls  show  roujnd 

Section  2.2.2 

Tarble  2.2-177:  ammo  restore  ammo  Information. 


2.2.5.1.66  anfcmo_resupply_sent 

This  routine  is  onl/y  used  by  the  keyboard. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

ammo  type 

int 

Standard 

1  Errors  1 

Error 

Reason  for  Error 

stderr  AMMO:P  amrrio  resupply  sent 

impossible  resupply  location 

1  Calls  1 

Function 

Where  Described 

ammo  decide  resupply  send 

Section  2.2.5.1.67 

controls  resupply  empty 

Section  2.2.2 

need  to  send  vel*  status 

Section  2.1.1.3.1.32.1 

sound  make  cons?,  sound 

Section  2. 1.3. 1.2 

controls  unshow  round 

Section  2.2.2 

ammo  subtract  round 

Section  2.2.5.1.42 

controls  resupply  restore 

Section  2.2.2 

Taj^jle  2.2-178:  ammo_resuppIy_sent  Information. 
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2.2.5.1.67  ainino_decide_resupply_send 

This  routine  determines  whether  the  ammunition  passed  in  ammo  jype  is  available  to  send 
in  an  external  resupply. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

ammo  type 

int 

Standard 

Errors 

Error 

Reason  for  Error 

stderr  AMMO:  ammo_decide_resupply_send 

-  no  available  heat 

-  no  available  apds 

-  impossible  ammo  type 

Calls 

Function 

Where  Described 

ammo_decide  resupply  slot 

Section  2.2.5.1.68 

Table  2.2-179:  ammo_decide_resuppIy_send  Information. 
2.2.5.1.68  ammo_decide_resu pply_slot 

This  routine  finds  the  first  slot  in  the  ready  rack  containing  the  ammo  passed  in 
ammojype. 


I  Parameters  1 

Parameter 

Where  Typedef  Declared 

ammo  type 

int 

Standard 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

i 

register  int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

NULL_SLOT 

int 

all  slots  are  empty  or  contain 
wrong  ammo 

i 

int 

first  slot  in  ready  rack 
containing  appropriate  ammo 

Table  2.2-180:  ammo_decide_resuppIy_slot  Information. 

2.2.5.1.69  ammo_print_statistics 

This  routine  prints  ammunition  statistics  for  each  rack  and  ammunition  type. 

2.2.5.1.70  ammo_enable_autoloader 

This  routine  enables  the  autoloader.  The  autoloader  is  enabled  with  the  command  line  -A  in 
order  to  perform  ammo  transfers  without  a  person  acting  as  loader. 
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2. 2. 5. 2  inl_fuelsys.c 

(./sininet/release/src/vehicle/ml/src/ml_fuelsys.c  [ml_fuelsys.c]) 
This  CSU  keeps  track  of  the  Ml’s  fuel  supply. 


Includes: 

"stdio.h" 

"sim_types.h" 

"sim_dfns.h" 

"sim_macros.h" 

"libfail.h" 

"failure.h" 

"ml_fuelsys.h" 

"ml_fuel_df.h" 

"ml_ctrl.h" 

"ml_meter.h" 

"ml_engine.h" 

"timers.h" 

"timers_dfn.h" 

"ml_resupp.h" 

Declarations: 

fuel_warning_levels() 

fuel~meter_value() 

fuel~check”xfer_tiine() 

fuel_xfer_fuel()” 

fuel~rear“tank_not_empty() 

fuerresupply_FankX) 

rear3uel_level 

r_front_fueLlevel 

l_front_fuel_level 

fuel_xfer_ok 

xfer_timer_id 

fuel_level 

tank_selected 

xfer_status 

fuelsys_status 

xfer_pump_status 

fueLflow 

resupply_timer_id 

tank_bein&_resupplied 

total_resupplied 

rcsupply_status 

mcc_offering 

Defines: 

RESUPPLYJNTERVAL 

RESUPPLY_RATE 

FUEL_PER_INTERVAL 


NO_XFER  =  no  transfer,  TIMER_ON  =  on 
timer,  OK  =  can  transfer 

LOW  or  NORMAL 

REAR,  L_FRONT,  or  R_FRONT 

ON  =  transferring  fuel,  OFF  =  dormant 

WORKING  or  BROKEN 

WORKING  or  BROKEN 

fuel  usage  rate  in  gallons  per  hour 

The  timer  id  for  resupply 

The  tank  which  is  receiving  fuel 

The  fuel  taken  in  a  resupply  interval 

If  TRUE,  a  resupply  is  in  progress 

The  amount  of  fuel  offered  by  the  MCC 


Interval  (seconds)  before  sending  reply  to  the 
MCC 

GPM  of  fuel  transfer  from  truck 
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2. 2. 5. 2.1  fueMnit_tanks 

This  routine  is  used  by  the  MCC  to  intitialize  the  fuel  level  in  each  tank.  This  routine 
should  be  called  before  fuel  init(). 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

rear 

REAL 

sIm  types. h 

1  front 

REAL 

Sim  types. h 

bottomr  front 

REAL 

Sim  types. h 

Table  2.2-181:  fuel_init_tanks  Information. 

2. 3. 5. 2. 2  fueljnit 

This  routine  initializes  the  fuel  system.  The  transfer  status  variables,  resupply  status 
variables,  and  failures  are  inititalized. 


1  Calls  1 

Function 

Where  Described 

fail  init  failure 

Section  2.5.4.11.2 

Table  2.2-182:  fueMnit  Information. 

2. 2. 5. 2. 3  fuei^simul 

This  routine  simulates  the  various  functions  of  the  fuel  system  on  a  tick  by  tick  basis. 
These  functions  consist  of:  1)  calculating  fuel  usage  during  the  current  tick,  2)  turning  on 
the  fuel  warning  levels  if  transitioning  to  the  low  fuel  condition,  3)  calculating  the  levels  in 
each  tank  based  on  the  fuel  usage  this  tick,  4)  transferring  fuel  when  reqxured,  5) 
resupplying  fuel,  6)  stopping  the  fuel  resupply,  and  7)  setting  the  meter  to  read  the  amount 
of  fuel  in  the  tank  selected. 


I  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

fuel  usage  this  tick 

REAL 

Sim  types. h 

I  Calls  I 

Function 

Where  Described 

fuel  warning  levels 

Section  2.2.5.2.5 

Section  2.2.6.2.2.8 

fuel  rear  tank  not  empty 

Section  2.2.5.27 

fuel  check  xfer  timer 

Section  2.2.5. 2.6 

fuel  xfer  fuel 

Section  2.2.5.2.12 

fuel  resupply  tank 

Section  2.2.5.2.24 

timers  get  ticking  status 

Section  2.6.3.20.1 

fuel  stop  resupply 

Section  2.2.5.2.23 

fuel  meter  value 

Section  2.2.5.2.4 

Table  2.2-183:  fuel  simul  Information. 
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2. 2. 5. 2. 4  fuel_meter_value 

This  routine  sets  the  fuel  tank  meter  to  show  the  fuel  level  in  the  tank  selected  by  the  tank 
select  switch. 


1  Errors  I 

Error 

Reason  for  Error 

stderr 

WARNING;  invalid  tank  selected 

Calls 

Function 

Where  Described 

meter  fuel  set 

Section  2.2.2.3.1 

Table  2.2-184:  fuel_meter_value  Information. 

2. 2. 5. 2. 5  fuel_warning_Ievels 

This  routine  calls  the  controls  software  to  turn  on  the  fueljeveljow  light  on  when  the  rear 
fuel  tank  is  less  than  or  equal  to  1/4  full.  The  routine  calls  the  controls  software  to  turn  off 
the  fueljeveljow  light  once  the  fuel  level  has  reached  the  3/8  full  level.  Fuel  cannot  be 
transferred  unless  the  fueljeveljow  light  is  on. 


I  Calls  I 

Function 

Where  Described 

controls  low  fuel  off 

Section  2.2.2 

controls  low  fuel  on 

Section  2.2.2 

Table  2.2-185:  fuel_warning_levels  Information. 

2. 2. 5. 2. 6  fuel_check_xfer_timer 

When  master  power  is  turned  on,  there  is  a  5  second  period,  counted  by  the  fuel  transfer 
timer,  xferjimer  jd,  during  which  fuel  cannot  be  transferred.  This  routine  checks  to  see  if 
the  fuel  transfer  timer  has  timed  out. 


I  Calls  I 

Function 

Where  Described 

ti-mers  qet  ticking  status 

Section  2.6.3.20.1 

timers  free  timer 

Section  2.6.3.5.1 

Table  2.2-186:  fuel_check_xfer_timer  Information. 
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2 . 2 . 5 . 2 . 7  fueI_rear_tank_not_empty 

This  routine  returns  TRUE  if  the  rear  fuel  tank  level  is  above  the  minimum  fuel  level,  and 
FALSE  if  the  level  is  below  the  minimum  fuel  level. 


1  Return  Values  1 

Return  Value 

Meanina 

rear  fuel  level  > 

MIN  FUEL  LEVEL  ?  TRUE  : 
FALSE 

BOOLEAN 

If  TRUE,  the  rear  fuel  tank  level 
is  above  the  minimum  level; 

If  FALSE,  the  rear  fuel  tank 
level  is  below  the  minimum 
level 

Table  2.2-187:  fuel_rear_tank_not_empty  Information. 


2. 2. 5. 2. 8  fuel  set  flow 


This  routine  sets  the /we/ Jlow  variable  equal  to  the  parameter  value. 


1  Parameters  I 

Parameter 

Where  Tvoedef  Declared 

value 

REAL 

Sim  types. h 

1  Return  Values  I 

Return  Value 

Meaning 

fuelsys_status  && 
fuel_lop_lank_not_empty() 

BOOLEAN 

If  TRUE,  then  the  fuel  button 
is  ON,  the  rear  fuel  tank  is 
not  empty,  and  the  fueljlow 
variable  is  set  to  value; 

If  FALSE,  then  either  the  fuel 
button  is  OFF  or  the  rear  fuel 
tank  is  empty 

1  Calls  1 

Function 

Where  Described 

fuel  rear  tank  not  empty 

Section  2. 2. 5.2. 7 

Table  2.2-188:  fuel  set  flow  Information. 


2. 2. 5. 2. 9  fuel_select_front_left_tank 

This  routine  is  called  when  the  fuel  tank  selector  switch  is  switched  to  the  left  front  tank 
position.  The  meter  will  automatically  display  the  fuel  in  the  left  front  tank.  Also,  if  the 
fuel  level  is  LOW  and  the  transfer  status  is  OK,  a  transfer  of  fuel  from  the  left  front  tank  to 
the  rear  tank  will  commence. 


1  Errors  1 

Error 

Reason  for  Error 

stderr 

Fuel  tranter  pump  broken 

Table  2.2-189:  fuel_select_front_left_tank  Information. 
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2.2.5.2.10  fuel_select_front_right_tank 


This  routine  is  called  when  the  fuel  tank  selector  switch  is  switched  to  the  right  front  tank 
position.  The  meter  will  automatically  display  the  fuel  in  the  right  front  tank.  Also,  if  the 
fuel  level  is  LOW  and  the  transfer  status  is  OK,  a  transfer  of  fuel  from  the  right  front  tank 
to  the  rear  tank  will  commence. 


1  Errors  I 

Error 

Reason  for  Error 

stderr 

Fuel  tranter  pump  broken 

Table  2.2-190:  fuel_seiect_front_right_tank  Information. 
2.2.5.2.11  fuel_select_rear_tank 

This  routine  is  called  when  the  fuel  tank  selector  switch  is  switched  to  the  rear  tank 
position.  When  the  rear  tank  is  selected,  any  transfer  that  has  been  taking  place  will  be 
stopped.  If  the  fuel  level  is  NORMAL,  no  more  fuel  can  be  transferred  until  it  becomes 
LOW. 


2.2.5.2.12  fuel_xfer_fuel 

This  routine  calculates  the  right  front,  left  front,  and  rear  tank  levels  after  a  fuel  transfer 
between  tanks.  If  a  fuel  transfer  is  in  progress,  it  ends  if  either  1)  the  supply  tank  becomes 
empty,  2)  the  selector  switch  is  switched  back  to  rear  tank,  during  which  the  transfer 
cannot  be  resumed  unless  the  fuel  low  light  is  still  on,  or  3)  the  rear  tank  reaches  3/4  full. 


1  Errors  1 

Error 

Reason  for  Error 

stderr 

WARNING:  invalid  tank  selection  tor  transter 

Table  2.2-191:  fuel_xfer_fuel  Information. 

2.2.5.2.13  fuel_master_power_on 

This  routine  is  called  by  the  electrical  system  software  to  let  the  fuel  system  know  that  the 
master  power  has  been  turned  on.  A  5  second  delay  after  master  power  has  been  turned 
on  is  counted  by  xfer  timer  id  in  order  to  prevent  accidental  fuel  transfers. 


1  Calls  1 

Function 

Where  Described 

timers  aet  timer 

Section  2.6.3.6.1 

Table  2.2-192:  fuel_master_power_on  Information. 
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2.2.5.2.14  fuel_master_power_off 

This  routine  is  called  by  the  electrical  system  software  to  let  the  fuel  system  know  that  the 
master  power  has  been  turned  off.  When  the  master  power  is  turned  off,  fuel  can  no 
longer  be  transferred. 


1  Calls  1 

Function 

Where  Described 

timers  free  timer 

Section  2.6.3.5.1 

Table  2.2-193:  fueI_engine_accessory_off  Information. 


2.2.5.2.15  fuel  level  rear 


This  routine  returns  the  fuel  level  of  the  rear  fuel  tank. 


I  Return  Values  I 

Return  Value 

Type 

Meaninq 

rear  fuei  ievel 

REAL 

the  level  in  the  rear  fuel  tank 

Table  2.2-194:  fuel_level_rear  Information. 
2.2.5.2.16  fuel  level  left 


This  routine  returns  the  fuel  level  of  the  left  front  fuel  tank. 


I  Return  Values  I 

Return  Value 

Type 

Meaning 

l_front_fuel_level 

REAL 

the  level  in  the  left  front  fuel 
tank 

Table  2.2-195:  fuel  level  left  Information. 


2.2.5.2.17  fuel_level_right 

This  routine  returns  the  fuel  level  of  the  right  front  fuel  tank. 


I  Return  Values  I 

Return  Value 

Meaning 

r_front_fuel_level 

REAL 

the  level  in  the  right  front  fuel 
tank 

Table  2.2-196: 


fuel_level_right  Information. 
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2.2.5.2.18  fuel_repair_transfer_pump 


This  roudme  is  called  by  ''nil_repairs.c"  to  repair  a  broken  fuel  transfer  pump. 


1  Calls  1 

Function 

Where  Described 

controls  ricnht  pump  inoperative  off 

Section  2.2.2 

controis  le^t  pump  inoperative  off 

Section  2.2.2 

fuel  select  front  left  tank 

Section  2.2.5  2.9 

fuel  select  front  riqht  tank 

Section  2.2.5.2.10 

Table  2.2-197:  fuel_repair_transfer_pump  Information. 


2. 2. 5. 2.  19  fuel_transfer_pump_failure 

This  routimc  is  called  by  the  failures  module  to  break  the  fuel  transfer  pump. 


I  Errors  I 

Error 

Reason  for  Error 

stderr 

DAMAGE:  fuel  transfer  pump  failure 

Calls 

Function 

Where  Described 

controls  riaht  pump  inoperative  on 

Section  2.2.2 

controls  le#t  pump  inoperative  on 

Section  2.2.2 

Table  2.2-198:  fuel_transfer_pump_failure  Information. 
2.2.5.2.:20  fuel_supply_full 


This  routhne  calculates  whether  the  amount  of  fuel  in  the  parameter  delta  will  fill  the  fuel 
tanks. 


I  Parameters  I 

ParametaT 

Where  Typedef  Declared 

delta 

REAL 

Sim.  types. h 

1  Return  Values  1 

Return  V.alue 

Type 

Meanina 

TRUE 

BOOLEAN 

delta  will  fill  the  fuel  supply 

FALSE 

BOOLEAN 

delta  will  not  fill  the  fuel  supply 

Table  2.2-199:  fueI_suppIy_fuU  Information. 
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2.2.5.2.21  fuel_decide_resup  ply_quantity 


This  routine  calculates  the  amount  of  fuel  needed  to  fill  the  three  tanks.  It  returns  either  the 
maximum  quanity  of  fuel  allowed  to  transfer  in  one  resupply  interval  or  the  actual  amount 
of  fuel  necessary  to  fill  the  tanks  (whichever  is  lower). 


1  Internal  Variables  1 

Variable 

Tvoe 

Where  Typedef  Declared 

fuel  needed 

REAL 

Sim  types. h 

1  Return  Values  I 

Return  Value 

Meanina 

(int)  min(fuel  needed, 

FUEL  PER  INTERVAL) 

int 

the  quantity  of  fuel  necessary 
for  resupply 

Table  2.2-200:  fuel_decide_resupply_quantity  Information. 
2.2.5.2.22  fuel_start_external_resupply 


This  routine  starts  the  process  of  externally  resupplying  fuel.  If  the  amount  of  fuel  the 
MCC  is  offering  is  less  than  0  gallons,  the  routine  returns  FALSE.  Otherwise,  the  routine 
starts  the  resupply  timer,  determines  which  tanks  should  be  resupplied,  and  returns  TRUE. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

fuel  offered 

int 

Standard 

1  Return  Values  I 

Return  Value 

Type 

Meanlnq 

TRUE 

BOOLEAN 

the  external  resupply  was 
started 

FALSE 

BOOLEAN 

the  external  resupply  was  not 
started 

1  Calls  1 

Function 

Where  Described 

timers  get  timer 

Section  2.6.3.6.1 

Table  2.2-201:  fuel_start_external_resupply  Information. 


2.2.5.2.23  fuel_stop_resupply 


This  routine  stops  the  fuel  resupply.  The  timers  are  freed,  the  resupply  status  is  set  to 
OFF,  and  the  amount  of  fuel  received  during  the  resupply  is  calculated. 


I  Calls  I 

Function 

Where  Described 

timers  free  timers 

Section  2.6.3.5.1 

resupply  fuel__received 

Section  2.2.5.3.11 

Table  2.2-202:  fueI_stop_resupply  Information. 
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2.2.5.2.24  fuel_resupply_tank 

This  aoutine  calculates  the  amount  of  fuel  in  each  tank  after  a  fuel  resupply.  If  the  fuel 
trans»fer  is  in  progress,  it  ends  if  either  1)  the  supply  tank  becomes  empty,  2)  the  selector 
switcJh  is  turned  back  to  the  rear  tank,  during  which  the  transfer  cannot  be  resumed  unless 
the  furel  low  light  is  still  on,  or  3)  the  rear  tank  level  reaches  3/4  full. 


1  Errors  I 

Erroar 

Reason  for  Error 

stderr 

WARNING:  invalid  tank  selection  for  resupply 

Table  2.2-203:  fuel_resupply_tank  Information. 
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2. 2. 5. 3  inl_resupp.c 

(./simnet/release/src/vehicle/ml/src/ml_resupp.c  [ml_resupp.c]) 

Resupply  of  fuel  and  ammunition  is  coordinated  by  this  CSU. 

This  files  includes: 

"stdio.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"timers_dfn.h" 

"timers.h" 

"mun_type.h" 

"libnetwork.h" 

"pro_sim.h" 

"m  1  _ammo_df.h " 

"m  l_ammo_mx.h" 

"ml_ammo.h" 

ml_cntrl.h" 

"ml_tracks.h" 

"ml_repair.h" 

"ml.fueLdf.h" 

"pro_assoc.h" 

"assoc,  h" 


Defines: 

QUIET 

REQUEST 

LOADING 

WAITING 

SERVICING 

MAX_SERVICE_ENTITIES 

Declarations: 

ammo_carrier 

fueLcarrier 

ammo_receiver 

num_ammo_carriers 

num_fuel_carriers 

num_ammo_receivers 

ammo_carriers_near_here 

fuel_carriers_near_here 

ammo_receivers_near_here 

ammo_resupply_receive_state 

ammo_has_been_received 

ammo_that_was_received 

ammo_receive_timer_id 

ammo_carrier_id 
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fuel_resupply_receive_stae 

fuel_has_been_received 

fue!_that_was_receive<i 

fue!_rcceive_timer_id 

fuel_carrier_id 

ammo_resupply_send_state 

ammo_se''  i_timer_id 

aiiimo_receiver_id 

clear_ammo_ca  rrie  rs() 

clear_fuel_carriers() 

clear”ainino_receiv€rs() 

send_feed_me_packets_ainnio_carriers() 

send~feed_me”packets~fuel_carriers() 

ammo_receive_quiet_state() 

fuel_receive_quiet_state() 

amino_send  quiet_state() 

ainmo_receive_request_state() 

fuel_receive_request_state() 

ammo_send_waiting_state() 

ammo~receive_loading_state() 

fueI_receive_Ioadiiig_srate() 

ammo_send_servicing_state() 

ammo'resupply  receive  simul() 

fuel_resupply_receive_srmul() 

ainino_resupply  send^imulO 

vehicle_is_cIose7) 

2. 2. 5. 3.1  clear_ammo_carriers 

This  routine  clears  the  ammo  carriers  near  here  flag  to  FALSE  and  the  number  of  ammo 

carriers  to  zero. 

2. 2. 5. 3. 2  clear_fuel_carriers 

This  routine  clears  the  fuel  carriers  near  here  flag  to  FALSE  and  the  number  of  fuel 

carriers  to  zero. 

2. 2. 5. 3. 3  clear_amino_receivers 

This  routine  clears  the  ammojcarriersjtearJiere  flag  to  FALSE  and  the  number  of  ammo 

receivers  to  zero. 

2. 2. 5. 3. 4  print_resupply_status 

This  routine  prints  the  resupply  status  information. 
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2 . 2 . 5 . 3 . 5  send_feed_me_packets_ainmo_car  riers 

This  routine  sends  a  service  request  packet  to  each  of  the  ammo  carriers  on  the  network, 
requesting  the  specific  types  of  ammunition  necessary  for  resupply. 


1  internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

i 

ini 

Standard 

munition 

basic.h 

1  Calls  1 

Function 

Where  Described 

ammo  decide  round  type 

Section  2.2.5.1.63 

network  send  feed  me  packet 

Section  2.1.1.3.1.28.1 

Table  2.2*204:  send_feed_me_packets_ammo_carriers  Information. 
2 . 2 . 5 . 3 . 6  send_feed_me_packets_fuel_car  riers 

This  routine  sends  a  service  request  packet  to  each  of  the  fuel  carriers  on  the  network, 
requesting  a  specific  quantity  of  fuel  necessary  for  resupply. 


Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard 

munition 

vmmssmssmmmmm 

basic.h 

1  Calls  1 

Function 

Where  Described 

fuel  decide  resupply  quantity 

Section  2.2.5.2.21 

network  send  feed  me  packet 

Section  2.1.1.3.1.48.1 

Table  2.2-205:  send  feed  me  packets  fuel  carriers  Information. 
2 . 2 . 5 . 3 . 7  resupply_near_amii«o_carrier 

This  routine  maintains  the  list  of  close  v  ehicles  which  are  ammo  carriers.  If  any  ammo 
carriers  are  on  this  list,  the  ammo _carriers  near _here  flag  is  set  to  TRUE. 


Parameters 


Parameter 

Type 

Where  Typedef  Declared 

V 

pointer  to  VehiclelD 

basic.h 

Table  2.2-206:  resupply  near  ainmo  carrier  Information. 
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2 .2 . 5 . 3 .8  resupply_near_fuel_carrier 

This  routine  maintains  the  list  of  close  vehicles  which  are  fuel  carriers.  If  any  fuel  carriers 
are  on  this  list,  the  fuel  carriers  near  here  flag  is  set  to  TRUE. 


Parameters 


Parameter 

Where  Typedef  Declared 

V 

1  pointer  to  VehiclelD  1 

basic.h 

Table  2.2-207:  resupply_near_fuel_carrier  Information. 

2. 2. 5. 3. 9  resupply_near_ammo_receiver 

This  routine  maintains  the  list  of  close  vehicles  which  are  ammo  receivers.  If  any  ammo 
receivers  are  on  this  list,  the  ammo  receivers  near  here  flag  is  set  to  TRUE. 


Parameters 


Parameter 

Where  Typedef  Declared 

V 

1  pointer  to  VehiclelD  I 

basic.h 

Table  2.2-208:  resupply_near_ammo_receiver  Information. 
2.2.5.3.10  resupply_ammo_received 

This  routine  sets  the  ammo  JiasJxen  received  flag  to  TRUE,  and  set  the  variable 
ammo_that_was_received  to  the  quantities  and  types  of  ammunition  that  were  received. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

ammo  type 

basic.h 

Table  2.2-209:  resupply  ammo  received  Information. 

2. 2. 5. 3. 1 1  resupplyfuelreceived 

This  routine  sets  the  fueljias  been  received  flag  to  TRUE  and  sets  the  variable 
fuel_that_was_received  equal  to  the  number  of  gallons  of  fuel  that  were  received. 


Parameters 


Parameter 

Where  Typedef  Declared 

aallons 

1  int  1 

Standard 

Table  2.2-210:  resupply  fuel  received  Information. 

2. 2. 5. 3. 1 2  resupply  offer  packet 

This  routine  is  called  by  the  LibRcvNet  routine  process_rcsupply_offer()  in  order  to 
process  a  message  from  a  vehicle  within  range  offering  munitions  resupply. 
resupply_offer_packet()  first  determines  the  types  and  quantities  of  munitions  offered, 
and  then  checks  the  ammo  and  fuel  resupply  receive  stales 
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If  the  resupply  receive  state  is  QUIET,  no  munitions  have  been  requested  and  no  munitions 
are  received.  If  the  state  is  REQUEST,  the  resupply  timer  is  started,  the  external  resupply 
of  either  fuel  or  ammunition  (heatlOS  or  apdslOS)  is  started,  and  the  state  is  changed  to 
LOADING.  If  the  state  is  LOADING,  the  extern^  resupply  is  in  progress.  If  the  receive 
state  is  not  known,  an  error  is  printed.  Parameters  are  represented  as  follows: 

carrier  Jd  —  The  VehiclelD  of  the  munitions  carrier. 

num  munitions  -  The  number  of  mun  itions  types  carried. 
munitions  —  The  quantities  and  types  of  munitions  being  carried. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

carrier  id 

pointer  to  VehiclelD 

basic.h 

num  munitions 

usiqned  char 

Standard 

munitions 

register  pointer  to 
MunitionQuantity 

basic.h 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

fuel 

int 

Standard 

apds105 

int 

Standard 

heat  105 

int 

Standard 

mun  type 

ObjectType 

basic.h 

float 

Standard 

li 

int 

Standard 

1  Errors  1 

Error 

Reason  for  Error 

RESUPPLY:  resupply_offer_packet 

-  unkown  ammo  state 

-  unknown  fuel  state 

1  Calls  1 

Function 

Where  Described 

timers  free  timer 

Section  2. 6.3.5. 1 

ammo  start  external  resupply 

Section  2.2.5.1.59 

timers  qet  timer 

Section  2. 6.3. 6.1 

Table  2.2-211:  resupply_offer_packet  Information. 
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2.2.5.3.13  resuppIy_thank_you_packet 

This  routine  is  called  by  the  LibRcvNet  routine  process_resuppIy_received()  in  order 
to  process  a  message  from  a  resupply  receiver  saying  that  the  ammo  was  received. 
resuppIy_thank_you_packet()  calculates  the  types  and  quantities  of  ammo  that  were 
sent  to  the  receiver,  frees  the  resupply  timer,  sets  Ae  resupply  send  state  to  QUIET,  and 
stops  the  ammo  resupply. 

receiver  Jd  —  The  Vehicle  ID  of  the  vehicle  which  received  the  ammo  resupplies. 

num  munitions  —  The  number  of  different  types  of  ammo  sent  by  the  carrier. 
munitions  —  The  quantity  of  each  type  of  ammo  sent  by  the  carrier. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

receiver  id 

pointer  to  VehiclelD 

basic,  n 

num  munitions 

unsioned  char 

Standard 

munitions 

register  pointer  to 
MunitionQuantity 

basic,  h 

1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard 

1  Calls  I 

Function 

Where  Described 

ammo  resupply  sent 

Section  2.2.5.1.66 

timers  free  timers 

Section  2. 6.3. 5.1 

Section  2.2.5.1.57 

Table  2.2-212:  resupply_thank_you_packet  Information. 
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2.2.5.3.14  resupply_feed_me_packet 

This  routine  is  called  by  the  LibRcvNet  routine  process_service_request()  in  order  to 
process  a  message  requesting  ammunition  resupply  from  a  vehicle  within  range. 
resupply_feed_me_packet()  first  checks  the  ammo  resupply  send  state.  If  the  state  is 
QUIET,  no  supp^lies  are  to  be  sent.  If  the  state  is  WAITING,  send  an  offer  packet  on  the 
network  to  the  receiver  listing  the  types  and  quantities  of  munitions  that  you  have,  start  the 
external  resupply,  and  change  the  state  to  SERVICING.  If  the  state  is  SERVICING,  the 
external  resupply  is  in  progress. 

receiver  Jd  —  The  VehiclelD  of  the  munitions  receiver. 

numjnunitions  —  The  number  of  ammo  types  requested  by  the  receiver. 

feed  rne  munitions  -  The  types  and  quantities  of  ammo  being  requested  by  the  reciever. 


Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

receiver  id 

pointer  to  VehiclelD 

basic.h 

num  munitions 

unsiqned  char 

Standard 

feed  me  munitions 

pointer  to  MunitionQuantity 

basic.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

offer  munitions 

pointer  to  MunitionQuantity 

basic.h 

Errors 

Error 

Reason  for  Error 

RESUPPLY:  resupply  feed  me  packet 

unknown  ammo 

Calls 

Function 

Where  Described 

timers  free  timers 

Secttion  2. 6.3.5. 1 

timers  aet  timer 

Secttion  2. 6.3.6. 1 

network  send  offer  packet 

Section  2.1.1.3.1.40.1 

ammo  start  external  send 

Section  2.2.5.1.60 

Table  2.2-213; 


resupply_feed_me_packet  Information. 
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2.2.5.3.15  resupply_gating_conditions 

This  routine  returns  TRUE  if  the  vehicle  is  not  moving  and  there  are  no  failures  in  controls. 
The  routine  returns  FALSE  if  the  vehicle  is  moving  or  there  is  a  failure  in  controls. 


Variable 


tracks  sneed 


Internal  Variables 


e 


REAL 


ID73 


Where  Typedef  Declared 


sim  tvDes.h 


Return  Value 


TRUE 


FALSE 


IE371! 


BOOLEAN 


BOOLEAN 


Return  values 


the  vehicle  is  not  moving;  no 
failures  in  the  controls 


either  the  vehicle  is  moving  or 
there  is  a  controls  failure 


Function 


drivetrain  oet  vehicle  speed 


controls  failure  status 


Calls 


Where  Described 


Section  2.2.6. 2.1 


Section  2.2.2 


Table  2.2-214:  resupply_gating_conditions  Information. 
2.2.5.3.16  ammof _recei ve_quiet_state 

This  routine  determines  the  receiver's  ammunition  resupply  Finite  State  Machine's  QUIET 
state.  If  the  following  conditions  are  ALL  TRUE: 

•  The  resupply  gating  conditions  are  TRUE  (the  vehicle  is  alive,  the  vehicle  is  not 
moving,  ami  no  controls  failures  exist). 

•  There  are  ammo  carriers  nearby. 

•  The  commareder  has  set  the  ammunition  transfer  switch  to  RED1ST_RECV. 

•  The  ammuniKion  load  in  the  tank  is  not  full. 

•  The  loader's  ;arms  are  empty. 

Then,  send  a  feed  me  packet  to  the  ammo  carriers  on  the  network  and  enter  the  REQUEST 
state.  If  any  of  the  conditions  are  not  met,  remain  in  the  QUIET  state. 


Return  Values 


Return  Value 


REQUEST 


QUIET 


Meanin 


the  receiver  is  in  the 
REQUEST  state 


the  receiver  is  in  the  QUIET 
state 


Calls 


Function 


atma  conditions 


ammo  decide  round  Type 


launcher  oet  val 


timers  oet  timer 


send  feed  me  packet;'  ammo  carriers 


Where  Described 


Section  2.2.5.3.15 


Section  2.2.5.1.63 


Section  2. 6.3. 6.1 


Section  2. 2. 5.3. 5 


Table  2.2-215;  ammo  receive  quiet  state  Information. 
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2.2.5.3.17  fuel_receive_quiet_state 

This  routine  determines  the  receiver's  fuel  resupply  Finite  State  Machine's  QUIET  state.  If 
the  following  conditions  are  ALL  TRUE: 

•  The  resupply  gating  conditions  are  TRUE  (the  vehicle  is  alive,  the  vehicle  is  not 
moving,  and  no  controls  failures  exist). 

•  There  are  fuel  carriers  nearby. 

•  There  is  room  for  the  fuel. 

Then,  send  a  feed  me  packet  to  the  fuel  carriers  on  the  network,  start  the  resupply  timer, 
and  enter  the  REQUEST  state.  If  any  of  the  conditions  are  not  met,  remain  in  the  QUIET 
state. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

REQUEST 

int 

the  receiver  is  in  the 

REQUEST  state 

QUIET 

int 

the  receiver  is  in  the  QUIET 
state 

1  Calls  1 

■  Function  1 

Where  Described 

Section  2.2.5.3.15 

fuel  supply  full 

Section  2.2.5.2.20 

timers  get  timer 

Section  2. 6.3.6. 1 

send  feed  me  packets  fuel  carriers 

Section  2.2.5.3.5 

Table  2.2-216:  fuel_receive_quiet_state  Information. 


2.2.5.3.18  ammo_send_quiet_state 

This  routine  determines  the  sender's  ammunition  resupply  Finite  State  Machine's  QUIET 
state.  If  the  following  conditions  are  ALL  TRUE: 

•  The  resupply  gating  conditions  are  TRUE  (the  vehicle  is  alive,  the  vehicle  is  not 
moving,  and  no  controls  failures  exist). 

•  There  are  ammo  receivers  nearby. 

•  The  commander  has  set  the  ammunition  transfer  switch  to  REDIST_SEND_VAL. 

•  The  ammunition  load  in  the  tank  is  not  empty. 

•  The  loader's  arms  are  empty. 

Then,  enter  the  WAITING  state.  If  any  conditions  are  not  met,  remain  in  the  QUIET  state. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

WAITING 

int 

the  sender  is  in  the  WAITING 
state 

QUIET 

int 

the  sender  is  in  the  QUIET 
state 

1  Calls  1 

■  Function 

Where  Described 

Section  2.2.5.3.15 

Table  2.2-217:  ammo_send_quiet_state  Information. 


571 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


2.2.5.3.19  ammo_recei ve_request_state 


Hiis  routine  determines  the  receiver's  ammunition  resupply  Finite  State  Machine’s 
REQUEST  state.  If  ANY  of  the  following  conditions  are  TRUE: 

•  The  resupply  gating  conditions  are  FALSE  (the  vehicle  is  dead,  the  vehicle  is 
moving,  or  a  controls  failure  exists). 

•  There  are  no  ammo  carriers  nearby. 

•  The  commander  has  not  set  the  ammunition  transfer  switch  to 
REDIST_RECV_VAL. 

•  The  ammunition  supply  is  full. 

•  The  loader’s  arms  are  full. 

Then,  abort  the  resupply  timer  and  enter  the  QUIET  state.  If  none  of  the  conditions  are  met 
and  the  resupply  timer  has  expired,  send  another  service  request,  restart  the  timer,  and 
remain  in  the  REQUEST  state.  If  the  resupply  timer  has  not  expired,  remain  in  the 
REQUEST  state. 


1  Return  Values  I 

Return  Value 

Meaning 

QUIET 

int 

the  receiver  is  in  the  QUIET 
state 

REQUEST 

int 

the  receiver  is  in  the 

REQUEST  state 

1  Calls  1 

Function 

Where  Described 

resupply  qating  conditions 

Section  2.2.5.3.15 

timers  get  timeout  edge 

Section  2.6.3.22.1 

timers  free  timer 

Section  2.6.3.5.1 

timers  get  timer 

Section  2.6.3.6.1 

send  feed  me  packets  ammo  carriers 

Section  2. 2.5. 3.5 

Table  2.2-218: 


ammo_receive_request_state  Information. 
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2.2.5.3.20  fuel_recei ve_request_state 

This  routine  determines  the  receiver's  fuel  resupply  Finite  State  Machine's  REQUEST 
state.  If  ANY  of  the  following  conditions  are  TRUE: 

•  The  resupply  gating  conditions  are  FALSE  (the  vehicle  is  dead,  the  vehicle  is 
moving,  or  a  controls  failure  exists). 

•  There  are  no  fuel  carriers  nearby. 

•  The  fuel  supply  is  full. 

Then,  abort  the  resupply  timer  and  enter  the  QUIET  state.  If  none  of  the  conditions  are  met 
and  the  resupply  timer  has  expired,  send  another  service  request,  restart  the  timer,  and 
remain  in  the  RIFQUEST  state.  If  the  resupply  timer  has  not  expired,  remain  in  the 
REQUEST  state. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

REQUEST 

int 

the  receiver  is  in  the 

REQUEST  state 

QUIET 

int 

the  receiver  is  in  the  QUIET 
state 

Calls 

Function 

Where  Described 

resupply  qatinq  conditions 

Section  2.2.5.3.15 

fuel  supply  full 

Section  2.2.5.2.20 

timers  free  timer 

Section  2.6.3.5.1 

timers  qet  timeout  edqe 

Section  2.6.3.22.1 

timers  qet  timer 

Section  2.6.3.6.1 

send  feed  me  packets  fuel  carriers 

Section  2.2.5.3.5 

Table  2.2-219: 


fuel_receive_request_state  Information. 


573 


BEN”  Systems  and  Technologies 


Vehicles  CSCI 


2 .  Z  .5 . 3 . 2 1  amino_send_waiting_state 

This  noutine  determines  the  sender's  ammunition  resupply  Finite  State  Machine's 
WAITING  state.  If  ANY  of  the  following  conditions  arc  TRUEr 

•  The  resupply  gating  conditions  arc  FALSE  (the  vehicle  is  dead,  the  vehicle  is 
moving,  or  a  controls  failure  exists). 

•  There  arc  no  ammo  receivers  nearby. 

•  The  commander  has  not  set  the  ammunition  transfer  switch  to 
REDIST_SEND_VAL. 

•  The  ammunition  supply  is  empty. 

•  The  loader's  arms  are  full. 

Then,  enter  the  QUIET  state.  If  none  of  the  conditions  arc  met  remain  in  the  WAITING 
state. 


1  Return  Values  I 

Return;  Value 

Meanlnq 

QUIET 

int 

the  sender  is  in  the  QUIET 
state 

WAITING 

int 

the  sender  is  in  the  WAITING 
state 

1  Calls  1 

Function 

Where  Described 

resupply  qatinq  conditions 

Section  2.2.5.3.15 

Table  2.2-220; 


ammo_send_waiting_state  Information. 
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2.2.5.3.22  ammo_receive_Ioading_state 

This  routine  determines  the  receiver's  ammunition  resupply  Finite  State  Machine's 
LOADING  state.  If  the  ammo  has  been  received,  a  thank  you  packet  is  sent  by  the  receiver 
listing  the  type  and  amount  of  ammunition  taken,  and  the  receiver  enters  the  QUIET  state. 

If  ANV  of  the  following  conditions  have  changed  to  TRUE  in  the  LOADING  state; 

•  The  resupply  gating  conditions  are  FALSE  (the  vehicle  is  dead,  the  vehicle  is 
moving,  or  a  controls  failure  exists). 

•  There  are  no  ammo  carriers  nearby. 

•  The  ammo  carrier  which  offered  ammunition  is  dead. 

•  the  commander  has  not  set  the  ammunition  transfer  switch  to 
REDIST_RECV_VAL. 

•  The  loader's  arms  are  full. 

Then,  stop  the  resupply  and  enter  the  QUIET  state. 

If  the  loading  has  not  completed,  remain  in  the  LOADING  state. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

munitions 

MunitionOuantity 

basic. h 

1  Return  Values  I 

Return  Value 

Meaning 

QUIET 

int 

in  QUIET  staate 

LOADING 

int 

in  LOADING  state 

1  Errors  1 

Error 

Reason  for  Error 

AMMO:  ammo  receive  loadinq  state 

impossible  ammo  that  was  received 

1  Calls  1 

Function 

Where  Described 

network  send  thank  you  packet 

Section  2.1.1.3.1.41 

Section  2.2.5.3.15 

1  vehicle  is  close  I 

Section  2.2.5.3.34 

Section  2.2.5.1.57 

Table  2.2-221:  ammo_receive_Ioading_state  Information. 
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2.2.5.3.23  fuel_recei ve_loading_state 

This  routine  determines  the  receiver's  fuel  resupply  Finite  State  Machine's  LOADING 
state.  If  the  fuel  has  been  received,  a  thank  you  packet  listing  the  quantity  of  fuel  taken  is 
sent  by  the  receiver,  the  fuel  light  stops  flashing,  and  the  receiver  enters  the  QUIET  state. 

If  ANY  of  the  following  conditions  have  changed  to  TRUE  in  the  LOADING  state: 

•  The  resupply  gating  conditions  are  FALSE  (the  vehicle  is  dead,  the  vehicle  is 
moving,  or  a  controls  failure  exists). 

•  There  are  no  fuel  carriers  nearby. 

•  The  fuel  carrier  which  offered  fuel  is  dead. 

•  The  fuel  load  is  full. 

Then,  the  resupply  is  stopped,  a  thank  you  packet  listing  the  quantity  of  fuel  taken  before 
the  resupply  was  stopped  is  sent,  the  fuel  light  stops  flashing,  and  the  receiver  enters  the 
QUIET  state. 

If  the  loading  has  not  completed,  remain  in  the  LOADING  state. 


Variable 


munition 


Internal  Variables 


MunitionQuantit 


Where  Tvoedef  Declared 


basic,  h 


Return  Values 


Return  Value 


QUIET 


LOADING 


Meanin 


The  vehicle  is  in  the  fuel 
receive  auiet  state 


The  vehicle  is  in  the  fuel 
receive  loadinq  state 


Function 


network  send  thank  you  packet 


atino  conditions 


fuel  supply  full 


vehicle  is  close 


fuel  stop  resuppi 


Calls 


Where  Described 


Section  2.1.1.3.1.41 


Section  2.2.5.3.15 


Section  2.2.5.2.20 


Section  2.2.5.3.34 


Section  2.2.5.2.23 


Table  2.2-222:  fuel_receive_loading_state  Information. 
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2.2.5.3.24  ammo_send_servicing_state 

This  routine  determines  the  sender's  ammunition  resupply  Finite  State  Machine's 
SERVICING  state.  If  the  resupply  timer  has  timed  out,  stop  the  resupply  and  enter  the 
QUIET  state.  If  the  resupply  timer  has  not  timed  out,  remain  in  the  SERVICING  state. 
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2.2.5.3.26  fuel_resupply_receive_siinul 

This  routine  runs  the  fuel  resupply  receive  simulation.  The  routine  checks  the  fuel  resupply 
receive  state  and  calls  the  appropriate  routine  for  that  state. 


1  Errors  1 

Error 

Reason  for  Error 

REPAIR:  fuel  resupply  receive  simul 

unknown  state 

Calls 

Function 

Where  Described 

fuel  receive  quiet  state 

Section  2.2.5.3.17 

fuel  receive  request  state 

Section  2.2.5.3.20 

fuel  receive  loadinq  state 

Section  2.2.5.3.23 

Table  2.2-225:  fuel_resupply_receive_simul  Information. 
2.2.5.3.27  ammo_resupply_send_simuI 


This  routine  runs  the  ammunition  resupply  send  simulation.  The  routine  checks  the 
sender's  ammo  resupply  state  and  calls  the  appropriate  routine  for  that  state. 


I  Errors  I 

Error 

Reason  for  Error 

REPAiR:  ammo  resupply  send  simul 

unknown  state 

Calls 

Function 

Where  Described 

ammo  send  quiet  state 

Section  2.2.5.3.18 

ammo  send  waiting  state 

Section  2.2.5.3.21 

ammo  send  servicing  state 

Section  2. 2. .5. 3. 24 

Table  2.2-226:  ammo_resupply_send_simul  Information. 
2.2.5.3.28  resupply_init 

This  routine  initializes  the  resupply  simulation.  All  ammo  and  fuel  carriers  and  receivers 
are  cleared,  all  resupply  states  are  set  to  QUIET,  and  all  resupply  timers  are  set  to  NULL. 


1  Calls  1 

Function 

Where  Described 

clear  ammo  carriers 

Section  2.2. 5.3.1 

clear  fuel  carriers 

Section  2.2.5.3  3 

clear  ammo  receivers 

Section  2. 2.5. 3. 2 

Table  2.2-227:  resupply  init  Information. 
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2.2.5.3.29  resupply_simul 

This  routine  runs  the  resupply  simulations.  The  routine  calls  the  ammo  receive,  ammo 
send  and  fuel  receive  simulation  routines. 


1  Calls  1 

Function 

Where  Described 

ammo  resupply  receive  simul 

Section  2.2.5.3.25 

fuel  resupply  receive  simul 

Section  2.2.5.3.26 

ammo  resupply  send  simul 

Section  2.2.5.3.27 

clear  ammo  carriers 

Section  2. 2.5.3. 1 

clear  fuel  carriers 

Section  2.2.5.3.3 

clear  ammo  receivers 

Section  2.2.5.3.2 

Table  2.2-228:  resupply_simul  Information. 


2.2.5.3.29  service_check_vehicle_type 


This  routine  checks  the  vehicle  ID  from  the  pkt  parameter,  determines  its  vehicle  type,  and 
updates  the  different  lists  of  close  vehicles  (ammo  carriers,  fuel  carriers,  ammo  receivers, 
etc.). 


I  Parameters  I 

Parameter 

Where  Typedef  Declared 

pkt 

pointer  to 

VchicleAppearanceVariant 

p_sim.h 

I  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

id 

pointer  to  VehiclelD 

basic. h 

I  Return  Values  I 

Return  Value 

Type 

Meanina 

TRUE 

int 

procedure  was  successful 

I  Calls  I 

Function 

Where  Described 

is  fuel  vehicle 

Section  2.6.10.7.1 

resupply  near  fuel  carrier 

Section  2.2.5.3.8 

is  _repair_vehicle 

Section  2.6.10.10.1 

repair  near  repair 

Section  2.2.4. 2.5 

is  ammo  vehicle 

Section  2.6.10.2.1 

is  ammo  earner 

Section  2.6.10.2.2 

resupply  near  ammo  carrier 

Section  2. 2.5.3. 7 

is  main  battle  tank 

Section  2.6.10.9.1 

resupply  near  ammo  receiver 

Section  2.2.5.3.9 

resupply  near  ammo  carrier 

Section  2. 2. 5.3. 7 

Table  2.2-229:  service_check_vehicle_type  Information. 
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2.2.5.3.30  resnp ply_stop_ammo_resuppIy 

Thiis  routine  aborts  tfue  ammo  resupply  simulation,  resetting  the  ammo  resupply  send  (or 
recieive)  state  to  QUIET  and  freeing  the  resupply  timer. 


1  Calls  1 

Fumctlon 

Where  Described 

timers  free  timer 

Section  2. 6.3. 5.1 

Table  2.2-230:  resupply  stop  ammo  resupply  Information. 
2.2.5.3.31  resupply_stop_f  uelresu  pply 

Thiis  routine  aborts  the  fuel  resupply  simulation,  resetting  the  fuel  resupply  receive  state  to 
QUIET  and  freeing  the  resupply  timer. 


1  Calls  1 

Function 

Where  Described 

time-rs  free  timer 

Section  2. 6.3.5. 1 

Table  2.2-231:  resupply_stop_fuel_resupply  Information. 
2.2.5.3.32  resuppIy_offer_canceled 

This  routine  cancels  an  offer  o:  service  from  another  vehicle. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

earner  id 

1  tnt  1 

Standard 

Table  2.2-232:  resupply  offer  canceled  Information. 


2.2.5.3.33  resupply  request  canceled 

Thiis  routine  cancels  a  request  for  service. 


1  Parameters  1 

Patrameter 

Where  Typedef  Declared 

rece.iver(id 

1  int  1 

Standard 

Table  2.2-233:  resupply  request  canceled  Information. 
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2.2.5.3.34 


vehicle  is  close 


This  routine  determines  if  a  particular  vehicle  is  on  the  close  vehicles  list. 


Parameters 


Parameter 

Where  Typedef  Declared 

list 

reaister  pointer  to  VehiclelD 

basic. h 

vehicle 

reqisfer  pointer  to  VehiclelD 

basic. h 

size  of  list 

register  int 

Standard 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

TRUE 

int 

vehicle  is  near. 

FALSE 

int 

vehicle  is  not  near. 

1  Calls  1 

Function 

Where  Described 

VEHICLE  IDS  EQUAL 

Sim  macros.h 

Table  2.2-234;  vehicle  is  close  Information. 
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2.2.6  Ml  Vehicle  Model 

There  are  a  number  of  vehicle  specific  simulation  functions.  Code  is  required  for  modeling 
the  relevant  moving  elements  of  a  vehicle.  It  is  necessary  to  simulate  the  forces  applied  to 
the  vehicle  by  its  propulsion  and  suspension  systems.  The  generation  and  use  of  electric 
and  hydraulic  power  is  simulated,  as  are  the  effects  of  the  user's  actions  on  the  visual 
displays.  This  CSC  is  broken  down  into  the  following  CSC’s; 

Internal  Kinematics 
Propulsion  Simulation 
Vehicle  Subsystems 


M1  Vehicle  Model 
5.2.6 


Internal 

_ I _ 

Propulsion 

_ 1 _ 

Vehicle 

Kinematics 

Simulation 

Subsystems 

5.2.6. 1 

5.2.6.2 

5.2.6.3 

mljurret.c 

5.2,6.1.1 


m1_cupola.c 

5.2.6.1.2 


m1_dtrain.c 

5.2.6.2.1 


m1_engine.c 

5.2.6.22 

mijracks.c 

52.6.2.3 


hm1_elecsys.c 
5.2.6.3.1 


—  ni1_hydrsys.c 
5.2,6.3.1 

—  m1_vision.c 

5.2.6.3.3 

—  mljhermal.c 

5.2.6.3.4 


Figure  2.2-7:  Structure  of  the  Ml  Vehicle  Model  CSC. 

2.2.6. 1  Internal  Kinematics 

The  Ml  has  components  which  move  with  respect  to  the  hull.  It  is  necessar>'  to  model  the 
movement  of  these  components;  however,  the  required  level  of  model  fidelity  varies  among 
them.  The  simulation  of  moving  components  on  the  Ml  is  accomplished  with  the 
following  CSU's: 

ml_  lunri.c 
ml_cupoUi.c 
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2.2.6.1.1  ml_turret.c 

(./simnet/release/src/vehicle/ml/src/ml_turret.c  [ml_turTet.c]) 

This  is  the  Turret  simulation  module.  It  includes  the  Stabalization  System  and  Gunner’s 
Primary  Signt  (GPS). 

The  vehicle  specific  characteristics  of  the  turrets  are  modeled  in  ml_turreLc.  The  vehicle 
specific  code  responds  to  commands  from  the  controls  and  determines  the  appropriate 
commands  to  send  to  libtunet.  The  response  depends  on  the  mode  of  operation  of  the 
turret  and  is  affected  if  a  turret  subsystem  has  failed.  The  operational  modes  and  failure 
status  are  tracked  in  vehicle  specific  code.  Functions  are  provided  to  send  commands  to  the 
sound  system  provide  information  to  other  components  of  the  simulation.  This  information 
is  need^  by  the  CIG  and  by  some  control  displays. 

The  design  of  the  Delta  Graphics  system  fixed  reticle  changes  the  relationship  between  the 
GPS,  reticle,  and  gun  in  the  simulated  Ml  tank  from  a  real  Ml  tank.  In  a  real  Ml,  if  the 
turret  is  not  moving,  or  if  the  turret  is  only  moving  because  of  the  stab  system,  then  the 
GPS,  reticle,  and  gun  all  point  in  the  same  direction.  However,  if  the  mrret  is  moving 
because  of  the  gunner's  or  commander's  handles,  then  the  reticle  and  GPS  will  be 
displaced  from  the  gun  tube  as  follows:  the  first  30  mils  of  lead  tracking  will  be 
compensated  for  by  the  GPS  only,  so  that  the  reticle  remains  centered  in  the  GPS.  Beyond 
30  mils  of  lead  tracking,  the  reticle  is  displaced  within  the  sight.  However,  because  of  the 
restrictions  placed  by  the  graphics  box,  the  Ml  simulator  contains  certain  compromises. 
The  GPS  always  points  the  same  way  as  the  turret,  whether  or  not  any  lead  tracking  needs 
to  be  performed.  All  lead  tracking  is  performed  by  displacing  the  gun  from  the  GPS. 

Includes: 

"stdio.h" 

"math.h" 

"sim_  types. h" 

"sim_(ifns.h" 

"sim_macros.h" 

"pro_data.h" 

"libturret.h" 

"libmatrix.h" 

"libkin.h" 

"libhull.h" 

"timers.h" 

"timers_dfn.h" 

"libfail.h" 

"failure.h" 

"libsound.h" 

"ml_bcs.h’' 

"ml_weapons.h" 

"ml_hydrsys.h" 

"ml_sound.h" 

"ml_sound_dfn.h" 

"ml_tracks.h" 

"ml_turret.h" 
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Defines: 


TURRET  DEBUG 

TURRET  FAILURES  DEBUG 
STAB  DEBUG 

GUN  BREAK  SPEED 

miles/hr 

SLEW  ELEC  SLOPE 

slew  rate  coeff 

SLEW  ELEC  INT 

slew  rate  coeff 

SLEW  HYDR  A 

cubic  coeff 

SLEW  HYDR  B 

cubic  coeff 

SLEW  HYDR  C 

cubic  coeff 

SLEW  HYDR  D 

cubic  coeff 

SLEW  HYDR  KICK  IN 

hydraulic  kick  in 

MIN  ELEC  SLEW  RATE 

ELEV  ELEC  SLOPE 

elev  rate  coeff 

ELEV  ELEC  INT 

elev  rate  coeff 

ELEV  HYDR  A 

cubic  coeff 

ELEV  HYDR  B 

cubic  coeff 

ELEV  HYDR  C 

cubic  coeff 

ELEV  HYDR  D 

cubic  coeff 

ELEV  HYDR  KICK  IN 

Hydraulic  kick-in 

The  following  are  defined  for  the  gunner’s  primary  sight: 


MAX_GPS_ELEV  degrees 

MIN_GPS_ELEV  degrees 

MAX_GPS_ELEV_SIN  degrees 

MIN_GPS_ELEV_SIN  degrees 


Declared: 

MAX_ELEC_ELEV_RATE 

MAX_ELEC_SLEW_RATE 

gps_rel_heading 

gps_rel_elevation 

gyro_speed 

gun_slew_handle, 

gun_elev_handle 

^s_slew_rate 

sin_elev_rads 

gun_on_stop 

gearbox_status 

elevation_status 

mount_int_status 

stab_status 

traverse_status 

controLengaged 

fire_cd_m^e 


between  0.0  and  1 .0 
between  - 1 .0  and  1 .0 
between  -1.0  and  1.0 
radians  per  frame 

the  number  of  radians  that  the  gun  is  elevated 
(relative  to  the  orientation  of  the  hull) 
TRUE  or  FALSE 

all  either  WORKING  or  BROKEN 


either  ON  or  OFF 
can  be  anv  of  these  three: 
FCM_NORMAL 
FCM_MANUAL 
FCM_EMERGENCY 
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can  be  any  of  these: 

GTD_UNCX)UPLED 
GTD_POWERED 
GTD_MANUAL 
can  be  any  of  these  three: 

GYROS_NOT_CHANGING 
GYROS_SPOOLING_UP 
GYROS_SPOOLING_DOWN 

It  takes  25  seconds  for  the  turret  gyros  to  completely  come  up  to  speed  ~  we  also  assume 
that  they  take  25  seconds  to  completely  spin  down  when  shut  off 
TOTAL_GYRO_TIME 
TOTAL_GYROFRAMES 
GYRO_SPOOLUP_RATE 


gun_turret_drive 


gyro_direction; 


It  takes  1.4  seconds  to  completely  elevate  or  depress  the  gun. 
TOTAL_ELEV_TIME  seconds 

TOTAL_ELEV_FRAMES 
MAX_ELEV_RATE 

It  takes  9.0  seconds  to  slew  the  turret  a  full  360  degrees. 
TOTAL_SLEW_TIME  seconds 

TOTAL_SLEW_FRAMES 
MAX_SLEW_RATE 


The  following  functions  are  declared: 
calc_elev_from_handle(); 
calc_slew_fTom_handleO; 
turret_gyros_simul(); 
turret_move(); 
tuiTet_calc_gun_elev(); 
turret_calc_turret_slew(); 
make_sound_of_no_turret_noise(); 
make_sound_of_no_elevating() ; 
make_sound_of_no_slewingO; 


2.2.6. 1.1.1  turret_init 

This  routine  initializes  the  turret  variables.  The  stab  vectors  are  also  initialized  in  order  to 
use  the  stabilization  system. 


1  Calls  1 

Function 

Where  Described 

turret  set  stab  sys 

Section  2.5.5.2.3 

fail  init  failure 

Section  2.5.4.11.2 

Table  2.2<235:  turret  init  Information. 
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2.2.6. 1.1.2  turret_simul 

This  routine  is  called  on  a  tick  by  tick  basis  to  model  the  turret.  Nothing  will  occur  until  the 
turret  gyros  are  operational.  When  in  manual  mode,  the  stabilization  is  not  operational. 
Note  Aat  the  stab  vectors  must  be  set  every  tick,  since  they  are  set  one  tick  ahead  of  use. 


1  Internal  Variables  | 

Internal  Variable 

Where  Typedef  Declared 

old  control  value 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

turret  ovrose  simul 

Section  2.2.6.1.1.12 

sound  make  const  sound 

Section  2. 1.3.1. 2 

bes  dump  lead  buffer 

Section  2.2.3.1.1 

turret  move 

Section  2. 2.6.1. 1.3 

make_sou  nd_of_no_tu  rret_n 
Oise 

Section  2.2.6.1.1.35 

set  turret  vars 

turret  set  stab  svs 

Section  2.5.5.2.18 

controis  turret  ref  ind 

Section  2.2.2 

turret  aet  ref  ind 

Section  2.5.5.2.16 

Table  2.2-236:  turret  simul  Information. 


2.2.6. 1.1.3  turret  move 


This  routine  is  called  by  turret_simul()  to  make  the  turret  slew  and  the  gun  elevate.  It 
checks  to  make  sure  that  the  subsystems  are  engaged  and  working  before  the  routines 
which  actually  perform  the  slewing  and  elevating  are  called. 


Internal  Variables  | 

Internal  Variable 

Type 

Where  Typedef  Declared 

sin  stab  azi  rot 

REAL 

sim  types. h 

sin_stab_eiev_rot 

REAL 

simjypes.h 

elev_rate 

REAL 

sim_types.h 

siew rate 

REAL 

simjypes.h 

Calls 

Function 

Where  Described 

turret  aet  stab  chanaes 

Section  2. 5. 5.2.5 

make_sound_of_no_turret_n 

Oise 

Section  2.2.6.1.1.35 

sound  of  turret  traversing 

Section  2.1.3.2.10 

turret  calc  turret  slew 

Section  2. 2. 6.1. 1.7 

turret  move  azimuth 

Section  2.5. 5. 2. 6 

make_sound_of  no_eievatin 

9 

Section  2.2.6.1.1.34 

turret  calc  gun  elev 

Section  2.2.6.1.1.10 

turret  move  elevation 

Section  2. 5.5.2. 7 

Tabic  2.2-237:  turret  move  Information. 
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2 . 2 . 6 . 1 . 1 . 4  tur  ret_get_gps_slew_rate 

This  routine  returns  the  gunner's  primary  sight  slew  rate.  The  ballistics  computer  system 
requires  this  information  to  determine  lead  tracking.  This  return  value  must  contain  only  the 
slew  rate  due  to  the  handles;  it  cannot  include  slewing  due  to  the  stab  system.  When  le^ 
tracking,  the  stab  system  is  ignored. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

gps_slew_rate  /DELTA_T 

REAL 

gps  slew  rate 

Table  2.2-238:  turret_get_gps_slew_rate  Information. 


2 . 2. 6. 1 . 1 . 5  turret_get_turret_slew_rate 

This  routine  returns  the  turret  slew  rate. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

gps_slew_rate  /DELTA_T 

REAL 

turret  slew  rate 

Table  2.2-239:  turret_get_gps_slew_rate  Information. 


2. 2. 6. 1.1. 6  turret_handles_values 

This  routine  is  called  by  handles  to  pass  on  the  values  of  the  gun  slew  rates,  the  gun 
elevation  rates,  which  handles  are  engaged,  and  whether  the  fast  slew  is  on. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

gun  slew  rate 

REAL 

Sim  types. h 

qun  elevate  rate 

REAL 

Sim  types. h 

handle  engaged 

int 

Standard 

Table  2.2-240:  turret  handles  values  Information. 
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2. 2. 6. 1.1. 7  turret  calc  turret  slew 


This  routine  moves  the  turret  in  azimuth.  In  addition  to  slewing  the  turret,  this  routine  is 
also  resposible  for  checking  to  make  sure  that  the  turret  is  not  moving  too  fast.  It  also 
checks  to  see  that  sufl&cient  hydraulic  pressure  is  available  before  starting  the  turret  move. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

control  handle 

REAL 

Sim  types. h 

sin  stab  azi  rot 

REAL 

Sim  types. h 

Internal  Variables 

Internal  Variable 

Tvoe 

Where  Typedef  Declared 

total  slew  rate 

REAL 

Sim  types. h 

slew  percent 

REAL 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

total slew rate 

REAL 

the  total  Slew  rate  of  the  turret 

1  Calls  1 

{Function  1 

Where  Described 

Section  2. 2. 6.1. 1.9 

hydraulic  slew  turret  reques 
t 

Section  2.2.6.4.2.10 

sound  of  turret  traversinq 

Section  2.1.3.2.10 

abs 

Sim  macros.h 

Table  2.2-241:  turret_calc_turret_slew  Information. 
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2. 2. 6. 1.1. 9  calc  slew  from  handles 


This  routine  is  called  by  turret_move_azimuth()  to  determine  how  far  to  slew  the  turret, 
based  on  the  deflection  of  the  gunner  or  commander's  handles.  The  parameter, 
gun  slew  handle,  is  the  norm^ized  handle  displacement,  where  -1.0  is  complete  deflection 
to  the  right,  +1  is  complete  deflection  to  the  left,  and  0.0  is  centered. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

Handle  disp 

register  REAL 

Sim  types. h 

1  Internal  Variables  I 

Internal  Variable 

Where  Typedef  Declared 

abs  slew  handle 

register  REAL 

Sim  types.h 

slew  rate 

register  REAL 

Sim  types.h 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

slew_rate 

REAL 

the  slew  rate 

1  Calls  1 

Function 

Where  Described 

abs 

Sim  macros.h 

mil  to  rad 

Sim  macros.h 

Table  2.2-242:  turret_calc_turret_slew  Information. 
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2.2.6.1.1.10  turret_calc_gun_elev 

This  routine  moves  the  gun  in  elevation.  In  addition  to  elevating  the  gun,  this  routine  is 
also  resposible  for  checking  to  make  sure  that  the  gun  is  not  moving  too  fast.  It  also 
checks  to  see  that  sufficient  hydraulic  pressure  is  available  before  actually  elevating  the 
gun. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

control  handle 

REAL 

sim  types. h 

sin  stab  elev  rot 

REAL 

sim  types. h 

Internal  Variables 

Internal  Variable 

Tvoe 

Where  Typedef  Declared 

total  elev  rate 

REAL 

sim_  types. h 

hydr  elev  percent 

REAL 

sim  types. h 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

total_elev_rate 

REAL 

the  total  elevation  rate 

1  Calls  1 

Function 

Where  Described 

calc  elev  from  handle 

Section  2.2.6.1.1.11 

abs 

sim  macros 

min 

Sim  macros 

hydraulic_elevate_gun_reque 

St 

Section  2.2.6.4.2.11 

sound  of  qun  elevafinq 

Section  2.1.3.2.11 

Table  2.2-243:  turret_calc_gun_elev  Information. 
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2.2.6.1.1.11  calc  elev  from  handle 


This  routine  is  called  by  turret_move_eIev  to  determine  how  far  to  elevate  the  gun  due  to 
the  deflection  of  the  gunner's  (or  commander’s)  handles.  The  parameter, 
gun_elev_handle,  is  a  number  between  -1.0  and  -^1.0,  where  -1.0  is  a  complete  deflection 
down,  +1.0  is  a  complete  deflection  up,  and  0.0  is  centered. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

handle  disp 

reaister  REAL 

Sim  types. h 

1  Internal  Variables  | 

Internal  Variable 

Type 

Where  Typedef  Declared 

abs  elev  handle 

reaister  REAL 

Sim  types. h 

elev  rate 

register  REAL 

Sim  types. h 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

elev rate 

REAL 

the  elevation  rate 

1  Calls  1 

Function 

Where  Described 

abs 

Sim  macros.h 

mil  to  rad 

Sim  macros.h 

Table  2.2-245:  calc  elev  from  handle  Information. 


2.2.6.1.1.12  turret_gyros_simul 


This  routine  is  called  by  turret_simul  to  simulate  spinning  up  or  spinning  down  of  the 
turret  gyros.  The  variable  'gyro_speed'  is  a  number  between  0.0  and  1.0  which  represents 
the  gyro's  speed  as  a  percentage  of  their  full  working  speed. 


1  Internal  Variables  | 

Internal  Variable 

Where  Typedef  Declared 

a  dir 

register  pointer  to  int 

standard 

a  speed 

register  pointer  to  REAL 

Sim  types.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

turret gyros status() 

int 

status  of  turret  gyros 

1  Calls  1 

1  Function  1 

Where  Described 

. . . 

Section  2.2.6.1.1.15 

Table  2.2-246:  turret_gyros_simuI  Information. 
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2.2.6.1.1.13  turret_gyros_spool_up 

This  routine  is  called  by  controls  when  turret  power  is  turned  on.  It  spools  the  gyros  up. 

2.2.6.1.1.14  tu rret_gy ros_spooI_down 

This  routine  is  called  by  controls  when  turret  power  is  turned  off.  It  spools  the  gyros 
down. 

2.2.6.1.1.15  turret_gyros_status 

This  routine  is  called  by  controls  to  determine  the  state  of  the  turret  gyros. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

GYROS_SPOOLED_UP 

int 

gyros  are  spooling  up 

GYROS_SPOOLED^DOWN 

int 

gyros  are  spooling  down 

GYROS_STILL_SPOOLING 

int 

still  spooling 

Table  2.2-247:  turret_gyros_status  Information. 


2.2.6.1.1.16  turret_break_gear box 

This  routine  breaks  the  gearbox  by  seting  gearbox_status  to  BROKEN. 

2.2.6.1.1.17  turret_repair_gearbox 

This  routine  repairs  the  gearbox  by  setting  gearbox_staius  to  WORKING. 

2.2.6.1.1.18  turret_break_ele vation  dri ve 

This  routine  breaks  the  elevation  drive  by  setting  elevation_status  to  BROKEN. 

2.2.6.1.1.19  turret_repair_elevation  drive 

This  routine  repairs  the  elevation  drive  by  setting  elevation_status  to  WORKING. 

2.2.6.1.1.20  turret  break  stab  system 

This  routine  breaks  the  stabalization  system  by  setting  stab_status  to  BROKEN. 

2.2.6.1.1.21  turret  repair  stab  system 

This  routine  repairs  the  stabalization  system  by  setting  stab_status  to  WORKING. 
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2.2.6.1.1.22  turret_break_inount_interface 

This  routine  causes  the  mount  interface  to  fail. 

2.2.6.1.1.23  turret_repair_mount_interface 

This  routine  repairs  the  mount  interface. 


2.2.6.1.1.24  turret_break_traverse_drive 

This  routine  causes  the  traverse  drive  to  fail. 


2.2.6.1.1.25  turret  repair  traverse  drive 

This  routine  repairs  the  traverse  drive. 


2.2.6.1.1.26  tu rret  fi re  cont rol  emergency 

This  routine  sets  the  fire  control  mode  to  FCM  EMERGENCY. 


2.2.6.1.1.27  turret_fire_manual 

This  routine  sets  the  fire  control  mode  to  FCM  MANUAL. 


2.2.6.1.1.28  turret  fire  control  normal 

This  routine  sets  the  fire  control  mode  to  FCM_NORMAL. 


2.2.6.1.1.29  turret_gun_turret_drive_uncoupled 

This  routine  uncouples  the  gun  and  the  turret. 


Calls 


FiTicilon  Where  Described 


sound  make  const  sound  Section  2. 1.3. 1.2 


Table  2.2-248:  turret_gur._turret_drive_uncoupIed  Information. 


593 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


2.2.6.1.1.30  turret_gun_turret_drive_powered 
This  routine  powers  the  gun  turret  drive. 


1  Calls  1 

Function 

Where  Described 

sound  make  const  sound 

Section  2. 1.3. 1.2 

Table  2.2-249:  turret_gun_turret_drive_powered  Information. 


2.2.6.1.1.31  turret_gun_turret_drive_manual 

This  routine  sets  the  gun  turret  drive  to  manual. 


1  Calls  1 

Function 

Where  Described 

sound  make  const  sound 

Section  2. 1.3. 1.2 

Table  2.2-250:  turret_gun_turret_drive_manual  Information. 


2.2.6.1.1.32  turret_collision_detected 

This  routine  is  called  by  kinematics  whenever  a  collision  is  detected.  It  determines  whether 
the  gun  was  pointing  in  the  direction  of  the  collision.  If  so,  it  checks  to  see  whether  to 
bre^  the  turret-mount  interface.  When  the  turret-mount  interface  is  broken,  the  gun  cannot 
be  elevated  (except  in  emergency  mode)  or  fired. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

aaent  id 

pointer  to  Vehicleld 

basic,  h 

event  id 

int 

Standard 

coll  sector 

int 

Standard 

1  Internal  Variables  | 

Internal  Variable 

Where  Typedef  Declared 

azimuth 

reqister  REAL 

Sim  types. h 

rel  sector 

register  int 

Standard 

t  to  h 

register  T  MATRIX 

Sim  types. h 

1  Calls  1 

Function 

Where  Described 

rad  to  mil 

Sim  macros.h 

tracks,  compute  velocity 

Section  2.2.6.2.3.10 

fail  break  system 

Section  2.5.4.8.1 

Table  2.2-251:  calc  elev  from  handle  Information. 
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2.2.6.1.1.33  ma ke_soun d_of_no_sle wing 

This  routine  causes  the  sound  of  the  turret  traversing  without  slewing  to  be  made. 


1  Calls  1 

Function 

Where  Described 

sound  of  turret  traversing 

Section  2.1.3.2.10 

Table  2.2-252:  niake_sound_of_no_sIewing  Information. 
2.2.6.1.1.34  make_sound_of_no_elevating 

This  routine  causes  the  sound  of  the  turret  moving  without  elevating  to  be  made. 


1  Calls  1 

Function 

Where  Described 

sound  make  const  sound 

Section  2. 1.3. 1.2 

Table  2.2-253:  make_sound_of_no_elevating  Information. 
2.2.6.1.1.35  make_sound_of_no_turret_noise 


This  routine  suppresses  the  sound  of  turret  motion. 


1  Calls  1 

Function 

Where  Described 

make  sound  of  no  slewing 

Section  2.2.6.1.1.33 

make  sound  of  no  elevatin 

^ _ 

Section  2.2.6.1.1.34 

Table  2.2-254:  turret_gun_turret_drive_manual  Information. 
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2.2.6.1.1.36  turret_get_gun_to_world 

This  routine  calculates  the  gun  to  world  transformation  matrix. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

a  to  w 

T  MATRIX 

Sim  types. h 

error 

VECTOR 

Sim  types. h 

Internal  Variables 

Internal  Variable 

Where  Tvoedef  Declared 

lead  azimuth 

REAL 

Sim  types. h 

1  Calls  1 

Function 

Where  Described 

bcs  set  ballistics  computer 

Section  2.2.3.1.13 

bcs  oet  lead  azimuth 

Section  2.2.3.1.14 

bcs  oet  superelevation 

Section  2.2.3.1.15 

turret  oet  a  to  w 

Section  2.5.5.2.13 

Table  2.2-255:  turret_get_gun_to_world  Information. 
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2. 2. 6. 1.2  inl_cupola.c 

(./sininet/release/src/vehicle/ml/src/ml_cupola.c  [ml_cupola.c]) 

The  periscope  views  for  the  commander  in  the  hatch  arc  modeled  by  a  rotating  cupola  with 
attached  viewports.  The  commander  turns  the  cupola  by  pressing  a  switch.  TT:e  loader  in 
the  Ml  has  a  periscope  as  well.  He  must  physically  turn  &e  periscope  just  as  he  does  in  a 
real  tank.  In  both  cases,  the  controls  code  determines  the  position  of  the  cupola  as  a 
percentage  of  its  full  range.  Ml_cupola.c  determines  the  angle  of  the  cupola  with  respect  to 
the  turret.  The  sine  and  cosine  are  made  available  to  the  CIG  so  the  appropriate  image  can 
be  drawn  in  the  periscope  viewports. 

Includes: 

"stdio.h" 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 

Defines: 

CWS_FIELD_OF_VIEW  -  300  degrees 

LPSCOPE_FIELD_OF_VIEW  -  330  degrees 

SPSCOPE_MOUNT_OFFSET  -  77  degrees 

Declarations: 
cws_sin  =  0.0 
cws_cos  =  1.0 
lpscope_sin  =  0.0 
lpscope_cos  =1.0 
new_cws_value  =  TRUE 
new_lpscope_value  =  TRUE 
cws_current_offset  =  0.0 
lpscope_current_offset  =  0.0 

2. 2. 6. 1.2.1  convert_disp_to_angle 

This  routine  sets  the  values  pointed  to  by  psin  and  pcos  to  the  sine  and  cosine  of  the  angle 
calculated  from  the  displacement  and  offset  arguments  {disp  and  offset) 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

disp 

REAL 

Sim  types. h 

fov 

REAL 

Sim  types. h 

psin 

pointer  to  REAL 

sim.types.h 

PCOS 

pointer  to  REAL 

sim_types.h 

offset 

REAL 

Sim  types.h 

1  Internal  Variables  I 

1  Internal  Variable 

Where  Typedef  Declared 

reqister  REAL 

simjypes.h 

Table  2.2-256:  convert_disp_to_angIe  Information. 
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2.2.6. 1.2.2  cupola_cws_new_value 

This  routine  sets  the  value  of  the  commander  weapon  system  offset  to  the  value  passed  in 
val. 


Parameters 


Parameter 

Where  Typedef  Declared 

val 

REAL 

Sim.  tvpes.h 

Table  2.2-251:  cupoIa_cws_new_value  Information. 


2. 2. 6. 1.2. 3  cupola_lscope_new_value 


This  routine  sets  the  value  of  the  loader's  periscope  offset  to  the  value  passed  in  val. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

val 

REAL 

Sim  tvpes.h 

Table  2.2-258:  cupoIa_lscope_new_value  Information. 


2.2.6. 1.2.4  cupola_simuI 


This  routine  performs  the  tick  by  tick  simulation  of  the  cupola.  The  routine  determines 
whether  the  cupola  moved,  and  if  so,  calculates  the  new  commander  weapon  system  or 
loader's  periscope  sine  and  cosine. 


1  Calls  1 

Function 

Where  Described 

convert  disp  to  angle 

Section  2.2.6. 1.2.1 

Table  2.2-259:  cupola_simul  Information. 


2.2.6. 1.2.5  cupola_init 

This  routine  initializes  the  value  of  the  commander  weapon  system  and  loader's  periscope 
offsets  at  0.0. 
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2. 2. 6. 2  Propulsion  Simulation 

The  following  CSU’s  model  the  Ml’s  propulsion  : 

ml_dtrain.c 

ml_enginex 

ml_tracks.c 


2. 2. 6. 2.1  ml_dtrain.c 

(./simnet/release/src/vehicle/ml/src/m  l_dtrain.c  [m  1  _dtrain.c]) 

This  module  Simulates  the  Detroit  Diesel  Allison  XI  10(X)-3B  hydrokinetic  automatic 
transmission  and  torque  converter,  final  drive,  and  drive  sprocket.  Failure  modes  for  the 
transmission,  oil  temperature  and  pressure  are  also  simulated. 

The  following  are  included: 

"stdio.h" 

"sim_dfns.h" 

"sim_macros.h" 

"sim_types.h" 

"libfail.h" 

"failure.h" 

"libsound.h" 

"ml.cntrl.h" 

"ml_dtrain.h" 

"ml_engine.h'' 

"ml_sound_dfn.h" 

"ml.tracks.h" 

The  following  are  defined: 

TORQUE_CONVERTER_SLOPE 

TORQUE_CONVERTER_INTERCEPT 

TORQUE_CONVERTER_VELOCnT_LOAD_COEFHCIENT 

R  Tranmission  lever  settings 

D 

L 

N 

PVT 

NEUTRAL  Gears 

PrVOT.STEER 

FI 

F2 

F3 

F4 

R1 

R2 

NEUTRAL_RATIO  Gear  Ratios 

PIV0T_STEER_RAT10 

Fl_RATIO 

F2_RATIO 

F3_RATIO 

F4_RATIO 
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Rl_RATIO 
R2_RATIO 

FINAL_DRIVE_RATIO 
F1_INERTIA 
F2_INERTIA 
F3_INERTIA 
F4_INERTIA 
Rl.INERTIA 
R2_INERTIA 
NEUTRAL_INERTIA 
PIVOT_STEER_INERTIA 
DRIVETRAIN_MISC_INERTIA 
SLIP.INERTIA 
TCI 
TC2 

SPROCKET_RADIUS 
TANK_WEIGHT 
TRACKS_WEIGHT 
CLUTCH_LOCKUP_SPEED 
UPSHIFT.SPEED 
DOWNSHIFT.SPEED 
REV_DOWNSHIFT_SPEED 
MIN_TRANSMISSION_OIL_PUMP_SPEED  rpm 
MIN_TC_STEER_SPEED  rpm 

MAX_TC_STEER_SPEED  rpm 

MAX_PIVOT_FD_SPEED 
SPROCKET_MPH_TO_RPM_CONVERSION  rpm 
TWOPI 

MAX_STEERING_SPR0CKET_SPEED_INCREMENT  rpm  (48.84  /  2.0) 

MAXIMUM_SERVICE_BRAKE_TORQUE  ft-lbs 

MAXIMUM_PARKING_BRAKE_TORQUE  ft-lbs 

BRAKING_STICTION_FACTOR 

SERVICE_BRAKE_LOCKUP_INCREMENT 

LOW 

NORMAL 

HIGH 


Gear  inertias(ft-lb-sec^2) 


Torque  Converter  Multiplier  Constants 

ft 

lbs 

lbs 

rpm 

ipm 

rpm 

rpm 


The  following  variables  are  declared; 
torque_converter_speed 
torque_converter_torque 
gearbox_speed 
sprocket_grav_torque 
sprocket_drag_torque 
left_sprocket_speed 
right_sprocket_speed 
net_drive_torque 
fmal_drive_torque 
final_drive  _grav_torque 
final_drive_drag_torque 
finaLdrive_brake_torque 
final_dri  ve_speed 
gearbox_torque 
steering_bar 
slip_state 


TC  output  rpm  =  gearbox  input  rpm 
TC  output  torque=gearbox  input  torque 
gearbox  output  rpm  =  FD  input  rpm 
load  torque  due  to  gravity 
load  torque  due  to  drag 
RPM  (adjusted  for  steering) 

RPM  (adjusted  for  steering) 

output  torque 

load  torque  on  FD  due  to  gravity 
load  torque  on  FD  due  to  drag 
load  torque  on  FD  due  to  braking 
FD  output  rpm  =  sprocket  rpm 

Steering  bar  position  (-1.0  to  l.O) 
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gear  NEUTRAL,F1,F2.F3,F4,R1,R2 

gear_ratio; 

transmission_select  R,  D,  N,  L  ,  PVT 

transniission_oil_temperature  NORMAL  or  HIGH 

transniission_oil_pressure  NORMAL  or  LOW 

transmission_oil_level  NORMAL  or  LOW 

service_brake 

parking_brake 

service_brake_status 

parking_brake_status 

transmission_failure_status 

transmission_oil_filter_status 

Folowing  are  the  Lumped  Moments  of  Inertia  (ft-lb-sec^)  for  the  entire  drivetrain  and 
transformed  vehicle  weight  as  they  appear  at  the  torque  convener  after  undergoing  the 
appropriate  gear  reductions.  Note:  These  are  variables  which  are  computed  once  at 
initialization  and  used  as  constants  during  the  course  of  the  simulation.  The  variable  names 
are  all  capitalized  (against  convention): 

F1_LUMPED_INERTIA 

F2_LUMPED_INERTIA 

F3_LUMPED_INERTIA 

F4_LUMPED_INERTIA 

R  1_LUMPED_INERTIA 

R2_LUMPED_INERTIA 

NEUTRAL_LUMPED_INERTIA 

PIVOT_STEER_LUMPED_INERTIA 

TANK_WEIGHT_INERTIA 

SPROCKET_MPH_TO_RPM_CONVERSION 

RADSEC_TO_RPM_CONVERSION 

2 . 2 . 6 . 2 . 1 . 1  dri  vetrain_load_torque_converter 

This  routine  computes  the  load  torque  on  the  torque  convener  given  the  engine  speed, 
rpm.. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

rpm 

REAL 

Sim  types. h 

Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

load  torque 

REAL 

Sim  types. h 

Return  Values 

Return  Value 

Meaninq 

load  torque 

REAL 

the  load  torque 

Table  2.2-260:  drivetrain_Ioad_torque_converter  Information. 
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2. 2. 6. 2. 1.2  drivetrain_lockup_cIutch 

ITiis  routine  determines  if  the  torque  converter  is  locked  up. 


1  Return  Values 

Return  Value 

Meanina 

ON 

int 

clutch  locked  up 

OFF 

int 

not  locked  up 

Table  2.2-261:  drivetrain_lockup_ciutch  Information. 


2 . 2 . 6 . 2 . 1 . 3  dri  vet  rain_torque_converter_s  peed 
This  routine  returns  the  torque  converter  output  speed  in  rpm. 


1  Return  Values 

Return  Value 

Type 

Meanlnq 

torque  converter  speed 

REAL 

torque  converter  speed 

Table  2.2-262:  drivetrain_torque_converter_speed  Information. 

2. 2. 6. 2. 1.4  drivetrain_neutral 

This  routine  sets  the  transmission  direction  selection  to  neutral. 

2. 2. 6. 2. 1.5  drivetrainjow 

This  routine  sets  the  transmission  direction  selection  to  low. 

2. 2. 6. 2. 1.6  drivetrain_drive 

This  routine  sets  the  transmission  direction  selection  to  drive. 

2. 2. 6. 2. 1.7  drivetrain_reverse 

This  routine  sets  the  transmission  direction  selection  to  reverse. 


2. 2. 6. 2. 1.8  drivetrainpivot 

This  routine  sets  the  transmission  direction  selection  to  pivot. 
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2 . 2 . 6 . 2 . 1 . 9  dri  vetrain_set_steering_bar 

This  routine  sets  the  steering  bar  position  to  the  passed  value  val. 


1  Parameters  I 

Parameter 

Where  Tvnedef  Declared 

val 

REAL 

Sim  types. h 

Table  2.2-263:  drivetrain_set_steering_bar  Information. 

2.2.6.2.1.10  drivetrain_set_service_brake 

This  routine  sets  the  service  brake  position  to  the  passed  value  val. 


1  Parameters  | 

Parameter 

Where  Tvpedef  Declared 

val 

REAL 

Sim  types. h 

1  Calls  1 

Function 

Where  Described 

sound  make  const  sound 

Section  2. 1.3.1. 2 

Table  2.2-264:  drivetrain  set  service  brake  Information. 


2.2.6.2.1.11  dri  vet  rain_set_parking_brake 

This  routine  sets  the  parking  brake,  making  the  appropriate  sound  effect. 


I  Calls  I 

Function 

Where  Described 

sounJ  make  const  sound 

Section  2. 1.3. 1.2 

Table  2.2-265:  drivetrain_set_parking_brake  Information. 

2.2.6.2.1.12  dri vetrain_release_parking_brake 

This  routine  releases  the  parking  brake,  making  the  appropriate  sound  effect. 


1  Calls  1 

Function 

Where  Described 

sound  make  const  sound 

Section  2. 1.3. 1.2 

Table  2.2-266:  drivetrain_release_parking_brake  Information. 

2.2.6.2.1.13  drivetrain_service_brake_failure 

This  routine  causes  the  failure  of  the  service  brake. 
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2.2.6.2.1.14  drivetrain_parking_brake_failure 

T.iis  routine  causes  the  failure  of  the  parking  brake. 

2.2.6.2.1.15  dri v€train_repair_service_brake 

This  routine  repairs  the  service  brake. 

2.2.6.2.1.16  drivetrain_repair_parking_brake 
This  routine  repairs  the  parking  brake. 

2.2.6.2.1.17  dri  vet  rain_transmission_select_neutral 

This  routine  returns  TRUE  if  the  drivetrain  is  in  neutral  and  returns  FALSE  otherwise. 


Return  Values 


Return  Value 


TRUE 


FALSE 


Meanin 


in  neutral 


not  in  neutral 


Table  2.2-267:  drivetrain_transinission_select_neutral  Information. 

2.2.6.2.1.18  ioad_sprocket 

This  routine  determines  the  load  on  the  tracks  sprocket. 


Calls 

Function 

Where  Described 

tracks  return  slip  state 

Section  2.2.6.2.3.28 

tracks_compute_friction_forc 

e 

Section  2.2.6.2.3.1 

tracks  compute  oravitv  load 

Section  2.2  6.2.3.3 

tracks  compute  drag  load 

Section  2. 2.6. 2.3. 4 

Section  2.2.6.2.3.10 


Table  2.2-268:  load_sprocket  Information. 
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2.2.6.2.1.19  coinpute_fd_brake_torque 

This  routine  returns  the  total  brake  torque. 


Internal  variables 


Internal  Variable 


service  brake  torque 


arkinq  brake  torque 


IEi73 


e 


REAL 


REAL 


Where  Typedef  Declared 


sim  tvoes.h 


Sim  tvoes.h 


Return  Values 

Return  Value 

Type 

Meaning 

parking_brakeJorque  + 
service  brake  torque 

REAL 

total  brake  torque 

Table  2.2-269:  compute_fd_brake_torque  Information. 

2.2.6.2.1.20  get_braking_factor 

This  routine  calculates  the  braking  factor. 


Internal  Variables 


Internal  Variable 


brakinq  factor 


e 


REAL 


Where  Tvoedef  Declared 


Sim  tvoes.h 


Return  Value 

Type 

brakingjactor 

REAL 

service_brake 

REAL 

Meanin 


the  braking  factor 


service  braking  factor 


Table  2,2-270:  get_braking_factor  Information. 


2.2.6.2.1.21  load_finaI_drive 

This  routine  determines  the  final  drive  load. 


Calls 

Function 

Where  Described 

compute  fd  brake  torque 

Section  2.2.6.2.1.19 

Table  2.2-271:  load  final  drive  Information. 


2.2.6.2.1.22  set  gear  ratio 

This  routine  sets  the  gear  ratio. 
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2.2.6.2.1.23  gearbox_shift 

This  routine  controls  the  gearbox  shift. 


Function 


fail  break  system 


set  near  ratio 


Calls 


Where  Described 


Section  2.5.4. 8.1 


Section  2.2.6.2.1.22 


Table  2.2-272:  gearbox_shift  Information. 


2.2.6.2.1.24  load_gearbox 

This  routine  calculates  the  torque  converter  speed  and  shifts  the  gearbox  if  necessary. 


Function 


earbox  shift 


Calls 


Where  Described 


Section  2.2.6.2.1.23 


Table  2.2-273:  Ioad_gearbox  Information. 


2.2.6.2.1.25  power_gearbox 

This  routine  calculates  the  gearbox  torque. 


2.2.6.2.1.26  current_fd_inertia 

This  routine  calculates  the  final  drive  inertia. 


Return  Values 


Return  Value 


inertia 


Type 


REAL 


Meaning 


final  drive  inertia 


Table  2.2-274:  current  fd  inertia  Information. 
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2.2.6.2.1.27  power_finaI_drive 

This  routine  powers  the  final  drive.  It  contains  the  integrator  for  the  entire  drivetrain. 


1  Internal  Variables  I 

Internal  Variable 

Where  Typedef  Declared 

new  fd  speed 

REAL 

sim  tvpes.h 

1  Calls  1 

Function 

Where  Described 

current  fd  inertia 

Section  2.2.6.2.1.26 

Table  2.2-275:  current  fd  inertia  Information. 


2.2.6.2.1.28  differential  steer 


This  routine  calculates  the  left  and  right  sprocket  speeds  with  the  steering  differential. 


I  Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

differential  steer  fd  rpm 

REAL 

Sim  tvpes.h 

tc  speed  ratio 

REAL 

sim_tvpes.h 

torque_converterJnput_spe 

ed 

REAL 

simjypes.h 

I  Errors 

Error  Name 

Reason  for  Error 

Steer  Error 

Unknown  gear 

I  Calls 

Function 

Where  Described 

engine  get  speed 

Section  2.2.6.2.2.11 

get  braking  factor 

Section  2.2.6.2.1.20 

Table  2.2-276:  differential_steer  Information. 
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2.2.6.2.1.29  power_sp rocket 

This  routine  calculates  the  left  and  right  track  speeds  in  miles  per  hour  and  sends  the  torque 
and  speed  to  the  tracks. 


1  internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

left  speed 

REAL 

Sim  types. h 

right  speed 

REAL 

Sim  types. h 

torque 

REAL 

simjypes.h 

1  Calls 

Function 

Where  Described 

differiential  steer 

Section  2.2.6.2.1.28 

tracks  send  velocities 

Section  2.2.6.2.3.14 

Table  2.2-277:  power_sprocket  Information. 


2.2.6.2.1.30  power_engine 

This  routine  performs  the  engine  simulation. 


Calls 


Function 


engine  simul 


Where  Described 


Section  2.2.6.2.2.7 


Table  2.2-278:  power_engine  Information. 

2.2.6.2.1.31  compute_Iumped_inertias 

This  routine  computes  the  equivalent  lumped  inertia  of  all  elements  in  the  drivetrain, 
including  the  effect  of  the  weight  of  the  tank  as  it  appears  to  the  final  drive  for  the  various 
gear  positions.  Note:  this  routine  is  only  called  once,  during  initialization. 


2.2.6.2.1.32  compute_compile_time_constants 

This  routine  is  called  once  at  initialization  to  compute  compile  time  constants. 


1  Calls  1 

Function 

Where  Described 

compute  lumped  inertias 

Section  2.2.6.2.1.31 

Table  2.2-279:  compute_compiIe_time_constants  Information. 
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2.2.6.2.1.33  po wer_tor que_con verter 

This  routine  computes  the  torque  converter  torque. 

1  Calls 

Function 

Where  Described 

enqine  qet  torque 

Section  2.2.6.2.2.11 

enqine  qet  speed 

Section  2.2.6.2.2.12 

Table  2.2*280:  power_torque_converter  Information. 


2.2.6.2.1.34  load_drivetrain 

This  routine  calculates  the  drivetrain  load  by  calling  the  sprocket,  final  drive,  and  gearbox 
load  functions. 

Calls 

Function  Where  Described 

load  sprocket _ Section  2.2.6.2.1.18 _ 

load  final  drive _ Section  2.2.6.2.1.21 _ 

load  gearbox  Section  2.2.6.2.1.24 

Table  2.2*281:  load  drivetrain  Information. 


i  2.2.6.2.1.35  power_drivetrain 


This  routine  calculates  power  on  each  drivetrain  component. 


1  Calls  i 

Function 

Where  Described 

power  enqine 

Section  2.2.6.2.1.30 

power  torque  converter 

Section  2.2.6.2.1.33 

power  qearbox 

Section  2.2.6.2.1.25 

power  final  drive 

Section  2.2.6.2.1.27 

power  sprocket 

Section  2.2.6.2.1.29 

Table  2.2*282:  power_drivetrain  Information. 
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2.2.6.2.1.36  send_transmission_oil_status 

This  routine  sends  status  information  to  the  transmission  oil  temperature  indicators  and  oil 
pressure  indicators. 


J  Calls  1 

Function 

Where  Described 

controls_transmission_oiLte 
mperature  hiah 

Section  2.2.2 

controls_transmission_oil_te 
mperature  normal 

Section  2.2.2 

controls_transmission_oil_pre 
ssure  low 

Section  2.2.2 

controls_transmission_oil_pre 
ssure  normal 

Section  2.2.2 

Table  2.2-283: 

send_transmission_oil_status  Information. 

2.2.6.2.1.37  send_trans_maintenance_status 

This  routine  sends  status  infomration  to  the  transmission  oil  level  and  oil  filter  status 
indicators. 

1  Calls  1 

Function 

Where  Described 

controlsjransmission_oilJev 
el  low 

Section  2.2.2 

controls_transmission_oilJilte 
r  cloaaed 

Section  2.2.2 

controls_transmission_oiUev 
el  normal 

Section  2.2.2 

controls_transmission_oiLfilte 
r  normal 

Section  2.2.2 

Table  2.2-284:  send  trans  maintenance  status  Information. 


2.2.6.2.1.38  send_dtrain_outputs 


This  routine  sends  the  drivetrain  output  status  to  the  indicators  in  the  controls  module. 


1  Calls  1 

Function 

Where  Described 

send  transmission  oil  status 

Section  2.2.6.2.1.36 

send_trans_maintenance_sta 

tus 

Section  2.2.6.2.1.37 

Table  2.2-285:  send_dtrain_outputs  Information. 
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2.2.6.2.1.39  trahsinission_oil_systeni_siinul 


This  routine  performs  the  transmission  oil  system  simulation.  It  calculates  the  status  of  oil 
temperature,  oil  pressure,  oil  filter  status,  and  oil  level. 


1  Calls  1 

Function 

Where  Described 

enaine  aet  speed 

Section  2.2.6.2.2.11 

Table  2.2-286:  transinission_oil_system_simul  Information. 


2.2.6.2.1.40  drivetrain  simul 


This  routine  performs  the  drivetrain  simulation.  It  is  called  on  a  tick  by  tick  basis.  It 
calculates  the  drive  train  load  and  performs  the  oil  system  simulation  and  tracks  simulation. 
It  sends  output  information  to  the  controls  system. 


1  Calls  1 

Function 

Where  Described 

load  drivetrain 

Section  2.2.6.2.1.34 

power  drivetrain 

Section  2.2.6.2.1.35 

transmission_oil_system_sim 

ul 

Section  2.2.6.2.1.39 

tracks  simul 

Section  2.2.6.2.3.25 

send  dtrain  outputs 

Section  2.2.6.2.1.38 

Table  2.2-287:  drivetrain  simul  Information. 


2.2.6.2.1.41  drivetrain  init 


This  routine  initializes  the  drivetrain.  It  initializes  the  status,  sets  initial  settings,  places  the 
tank  in  neutral,  sets  the  parking  brake  and  initializes  the  failures  package. 


1  Calls  1 

Function 

Where  Described 

enaine  init 

Section  2.2.6.2.2.22 

tracks  init 

Section  2.2.6.2.3.16 

compute_compile_time_coms 

tants 

Section  2.2.6,2.1.32 

controls  set  parkinq  brake 

Section  2.2.2 

fail  init  failure 

Section  2.5.2.5.4.11.2 

Table  2.2-288:  drivetrain  init  Information. 


2.2.6.2.1.42  dri vet rain_cIog_transmission_oil_filter 

This  routine  clogs  the  transmission  oil  filter. 
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i  Calls  1 

Fusiuctlon 

Where  Described 

dnwetrain_transmission_oilJe 

ak 

Section  2.2.6.2.1.44 

Table  2.2-290:  drivetrain  transmission  failure  Information. 
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2. 2. 6. 2. 2  ml_engine.c 

(./siinn^release/src/vehicle/ml/src/ml_engine.c  [ml..engine.c]) 

The  AVCO  Lycoming  AGT-ISOO  gas  turbine  engine  is  simulated  by  obtaining  the  desired 
power  setting  from  the  throttle  input,  and  computing  the  torque  output  from  a  linear  torque 
curve  model.  The  engine  maintains  its  own  dynamic  state  based  on  engine  inertia, 
transmission  load,  and  torque  output  Failures  are  maintained  for  oil  pressure,  oil 
temperature,  oil  filter,  coolant  temperature,  and  fuel  filter.  The  simulation  routines  arc 
accessed  from  ml_dtrain.c,  and  the  failure  routines  from  ml_failure.c.These  routines  are 
contained  in  the  CSU  ml_engine.c. 

The  following  arc  included: 

"stdio.h" 

"sim_dfns.h" 

"sim_macros.h" 

"sim_types.h" 

"dynlib.h" 

"libfaiLh" 

"failure.h" 

"libsound.h" 

"ml_engine.h" 

"ml.dtrain.h" 

"ml_sound_dfn.h" 

"ml_cntrl.h" 

"ml_meter.h" 

The  following  are  defined: 

ENGINE_TORQUE_INTERCEPT 
ENGINE_TORQUE  SLOPE 
ENGINE_INERTIA 
TACnCAL_IDLE_SPEED 
LOW_IDLE_SPEED 
MIN_ENGINE_OIL_PUMP_SPEED 
GOVERNOR_DROOP_SPEED 
MAX_RATED_ENGINE_SPEED 
ENGINE_OVERSPEED_RPM 
MAX_RUNAWAY_ENGiNE_SPEED 
KGOV_DROOP 

TWOPI 

IDLE_POWER_SETTING  0.06 
ENGINE_POWER_TIME_CONSTANT 
ENGINE_IDLE_TIME_CONSTANT 
SPECinC_FUEL_CONSUMPTION 
RPM_FT_LBS_TO_HP_CONVERSION 
CLOGGED_FILTER_POWER_LOSS 
MAX_FILTER_CLOGGED_TIME 
MAX_OIL_LEVEL_LOW_TIME 
SPOOLING_UP 
SPOOLING_DOWN 
RUNAWAY 
SPOOLING_TIME 
LOW 


in  ft-lbs-sec^ 

rpm 

rpm 

ipm 

rpm 

ipm 

rpm 

rpm 

Governor  power  droop  proportional 
to  gain 

Produces  slow  creep  (~2  mph)  in  F2 
sec 

gal/HP-hr 
twopi  /  33000 

sec  (=  30  min) 
sec  (=  30  min) 


if  master  power  off 
spool  up/down  time  (sec) 
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NORMAL 

HIGH 

• 

The  following  variables  are  declared: 

engine_speed; 

rpm 

engine_torque; 

ft-lbs 

throttle; 

0-  1.0 

power_setting; 

0-  1.0 

engine_max_available_power, 

0-  1.0 

tacjdle; 

ON  or  OFF 

engine_fuel_flow; 

gal/hr 

engine_failure_status; 

WORKING  or  BROKEN 

engine_starter_status; 

WORKING  or  BROKEN 

engine_pilot_relay_status; 

engine_cooling_system_status; 

engine_oil_filter_status; 

WORKING  or  BROKEN 

WORKING  or  BROKEN 

WORKING  or  BROKEN 

(BROKEN  =  CLOGGED) 

WORKING  or  BROKEN 

engine_fuel_filter_status; 

(BROKEN  =  CLCXjGED) 

engine_status; 

ON,  OFF, 

SPOOLING  UP,  SPOOLING  DOWN 

engine_oil_pressure; 

NORMAL  or  LOW 

engine_oil_temperature; 

NORMAL  or  HIGH 

engine_oil_level; 

NORMAL  or  LOW 

engine_oil_level_low_timer; 

sec 

engine  oil  filter  clogged  timer 

sec 

SPOOLING_INCREMENT 

computed  once  at  init 

RUNAWAY_SPOOLING_INCREMENT  computed  once  at  init 

• 

2. 2. 6. 2. 2.1  set_power 

This  routine  calculates  the  throttle  power  setting. 

Internal  Variables 


internal  Variable 


ttaraet  power  settin 


tthrottle  power  settin 


REAL 


REAL 


Where  Typedef  Declared 


Sim  types. h 


Sim  types. 


Calls 


function  Where  Described 


■first  order  lag  Section  2.5.7.6.1 


max  Sim  macros.h  (macro  definition 


Table  2.2-291;  set_power  Information. 
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2 . 2 . 6 . 2 . 2 . 2  compute_fuel_consuinption 

This  routine  computes  the  fuel  consumption  based  on  engine  speed  and  torque. 


1 Cans 1 

Function 

Where  Described 

fuel  set  flow 

Section  2.2.5.2  8 

spool  down  enqine 

Section  2.2.6.2.2.19 

Table  2.2-292:  compute_fuel_consumption  Information. 


2. 2. 6. 2. 2. 3  engine_dynamics 


This  routine  simulates  the  engine  dynamics.  It  calculates  engine  speed,  torque  converter 
load  and  speed,  and  calls  the  routine  to  calculate  fuel  consumption. 


I  Calls  1 

Function 

Where  Described 

set  power 

Section  2.2.6. 2.2.1 

drivetrain  lockup  clutch 

Section  2.2.6.2.1.2 

first  order  laa 

Section  2.5.7.6.1 

drivetrain_load_torque_conve 

rter 

Section  2.2.6.2.1.1 

drivetrain_torque_converter_ 

speed 

Section  2.2.6.2.1.3 

compute  fuel  .consumption 

Section  2.2.6.2.2.2 

Table  2.2-293:  engine_dynamics  Information. 


2. 2. 6. 2. 2. 4  send_engine_sound 


This  routine  determines  the  engine  sound  to  make  based  on  the  engine  status. 


1  Internal  Variables  I 

Internal  Variable 

Where  Typedef  Declared 

engine  sound 

REWAL 

Sim  types.h 

1  Calls  1 

Function 

Where  Described 

sound  make  var  sound 

Section  2. 1.3. 1.4 

Table  2.2-294:  send_engine_sound  Information. 
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2. 2. 6. 2. 2. 5  send_engine_controls_status 

This  routine  sends  the  status  of  the  engine  to  controls  in  order  to  set  the  instrument 
readings. 


Calls  1 

Function 

Where  Described 

controls_engine_oil_pressure 

iow 

Section  2.2.2 

controis_engine_oil_pressure 

normal 

Section  2.2.2 

controls_engine_oiLtemperat 
ure  high 

Section  2.2.2 

controls_engine_oiLtemperat 
ure  normal 

Section  2.2.2 

controls_engine_oilJeveLlo 

w 

Section  2.2.2 

controls_engine_oil_level_no 

tmal 

Section  2.2.2 

controls_engine_oil_filter_clo 

qqed 

Section  2.2.2 

controls_engine_oiLfilter_nor 

mal 

Section  2.2.2 

controls_engine_fuel_filter_cl 

oqqed 

Section  2.2.2 

controls-enginejueljilter- 

normal 

Section  2.2.2 

controls  engine  overspeed 

Section  2.2.2 

controls_engine_overspeed_ 

normal 

Section  2.2.2 

Table  2.2-295:  send_engine_controls_status  Information. 

2. 2. 6. 2. 2. 6  send_aII_outputs 

This  routine  sends  outputs  to  the  various  output  devices:  controls  status  to  the  controls, 
tachometer  settings  to  the  indicators,  and  sounds  to  the  sound  system. 


Calls 


Function  Where  Described 


send  enqine  sound  Section  2.2.6.2.2.4 


meter  tach  set  Section  2.2.2 


send  enqine  controls  status  Section  2.2.6,2.2.5 


Table  2.2-296:  send_all_outputs  Information. 
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2. 2. 6. 2. 2. 7  engine_oil_system_simul 

This  routine  simulates  the  engine  oil  system:  oil  pressure,  oil  level,  oil  temperature,  oil 
filter,  and  failures. 


1  Calls  1 

Function 

Where  Described 

fail  break  svstem 

Section  2.5.4.8.1 

Table  2.2-297:  engine_oil_systein_simuI  Information. 


2. 2. 6. 2. 2. 7  engine_simul 


This  routine  simulates  the  engine  system:  the  dynamics,  engine  speed,  status,  failures,  and 
outputs. 


I  Calls  I 

Function 

Where  Described 

enaine  dynamics 

Section  2. 2. 6. 2.2.3 

controls  enaine  started 

Section  2.2.2 

tail  break  svstem 

Section  2.5.4.8.1 

spool  down  enqine 

Section  2.2.6.2.2.19 

controls  enaine  abort 

Section  2.2.2 

enqine  oil  svstem  simul 

Section  2.2.6.2.2.7 

send  alLoutputs 

Section  2.2.6.2.2  6 

Table  2.2-298:  engine_simul  Information. 


2. 2. 6. 2. 2. 8  engine_running 


This  routine  returns  TRUE  if  the  engine  is  running  and  returns  FALSE  otherwise. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

TRUE 

int 

engine  running 

FALSE 

int 

Table  2.2-299:  engine_running  Information. 


2. 2. 6. 2. 2. 9  engine_spooling_up 


This  routine  returns  TRUE  if  the  engine  is  spooling  up  and  returns  FALSE  otherwise. 


1  Return  Values  1 

Return  Value 

Meaning 

TRUE 

int 

engine  spooling  up 

FALSE 

int 

not  running 

Table  2.2-300:  engine_spooling_up  Information. 
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2.2.6.2.2.10  engine_spooling_down 


This  routine  returns  TRUE  if  the  engine  is  spooling  down  and  returns  FALSE  otherwise. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

TRUE 

int 

engine  spooling  down 

FALSE 

int 

not  running 

Table  2.2<301:  engine_spooling*down  Information. 


2.2.6.2.2.11  engine_get_speed 


This  routine  returns  the  engine  speed. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

engine_speed 

REAL 

engine  speed 

Table  2.2-302:  engine_get_speed  Information. 


2.2.6.2.2.12  engine_get_torque 

This  routine  returns  the  engine  torque. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

enginejorque 

REAL 

engine  torque 

Table  2.2-303:  engine_get_torque  Information. 


2.2.6.2.2.13  engine_get_power 
This  routine  returns  the  engine  power. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

engine_power 

REAL 

engine  power 

Table  2.2-304:  engine_get_power  Information. 
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2.2.6.2.2.14  engine_get_max_power 

This  routine  returns  the  maximum  available  power  of  the  engine. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

engine_max_available_power 

REAL 

maximum  available  power 

Table  2.2-305:  engine_get_max_power  Information. 


2.2.6.2.2.15  engine_tac_idle_switch_on 

This  routine  sets  tac  jdle  to  ON. 

2.2.6.2.2.16  engine_tac_idle_switch_on 

This  routine  sets  tac  idle  to  OFF. 


2.2.6.2.2.17  engine_set_throttle 

This  routine  sets  the  value  of  the  throttle. 


Parameters 


Parameter 


val 


Typ,e, 


REAL' 


Where  Typedef  Declared 


sim  types. h 


Table  2.2-306:  engine_set_throttle  Information. 


2.2.6.2.2.18  engine_start_switch 
This  routine  starts  the  engine. 


1  Calls  1 

Function 

Where  Described 

drivetrain_transmission_select 

neutral 

Section  2.2.6.2.1.17 

sound  make  const  sound 

Section  2. 1.3. 1.2 

eleclsys_engine_start_reque 

St 

Section  2. 2. 6. 3. 1.8 

controls  engine  abort 

Section  2.2.2 

Table  2.2-307:  engine_start_switch  Information. 
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2.2.6.2.2.19  spool_down_engine 

This  routine  spools  down  the  engine. 


1  Calls  1 

Function 

Where  Described 

sound  make  const  sound 

Section  2. 1.3. 1.2 

controls_engine_spooling_d 

own 

Section  2.2.2 

Table  2.2-308:  spooI_down_engine  Information. 


2.2.6.2.2.20  engine  shutoff  switch 


This  routine  spools  down  the  engine  and  shuts  it  off  when  the  shutoff  switch  is  selected. 


I  Calls 

Function 

Where  Described 

spool  down  engine 

Section  2.2.6.2.2.19 

controls  engine  abort 

Section  2.2.2 

Table  2.2-309:  engine  shutoff  switch  Information. 


2.2.6.2.2.21  compute_engine_compile_time_constants 


This  routine  computes  the  spooling  increment  and  runaway  spooling  increment  at  compile 
time. 


2.2.6.2.2.22  engine  init 

This  routine  initializes  the  engine  and  sets  the  status  of  all  of  the  sybsystems. 


1  Calls  1 

Function 

Where  Described 

compute_engine  _compile_ti 
me  constants 

Section  2.2.6.2.2.21 

fail  init  failure 

Section  2.5.4.11.2 

Table  2.2-310:  engine_init  Information. 


2.2.6.2.2.23  engine  major  failure 

This  routine  breaks  the  engine  as  a  system. 


b?.() 
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2.2.6.2.2.24  engine_replace_po werpack 
This  routine  repairs  the  power  pack. 


1  Calls  1 

Function 

Where  Described 

drivetrain_replaceJransmissio 

n 

Section  2.2.6.2.1.47 

Table  2.2-311:  engine_repIace_powerpack  Information. 


2.2.6.2.2.25  engine_runaway_condition 

This  routine  sets  the  runaway  condition. 

2.2.6.2.2.26  engine_fix_runaway_condition 
This  routine  repairs  the  runaway  condition. 

2.2.6.2.2.27  starter_failure 

This  routine  causes  the  engine  starter  to  fail. 

2.2.6.2.2.28  engine_replace_starter 

This  routine  replaces  the  engine  starter. 

2.2.6.2.2.29  engine_pilot_relay_failure 

This  routine  causes  the  pilot  relay  to  fail. 

2.2.6.2.2.30  engine_replace_pilot_relay 
This  routine  replaces  the  pilot  relay. 

2.2.6.2.2.31  engine_clog_oil_filter 

This  routine  causes  the  oil  filter  to  be  clogged. 

2.2.6.2.2.32  engine_replace_oil_filter 

This  routine  replaces  the  oil  filter. 
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% 


2.2.6.2.2.33  engine_oil_leak 

This  routine  causes  an  engine  oil  leak. 


2.2.6.2.2.34  en gine_degrade_engine_power 

This  routine  causes  a  degradation  of  engine  power  to  a  maximum  passed  value,  value. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

value 

REAL 

Sim  types.h 

Table  2.2*312:  engine_degrade_engine_power  Information. 


2.2.6.2.2.35  engine_refilI_oil 

This  routine  sets  the  engine  oil  level  to  normal. 

2.2.6.2.2.36  engine_cooling_system_failure 
This  routine  causes  the  engine  cooling  system  to  fail. 


2.2.6.2.2.37  engine_repair_cooling_system 

This  routine  repairs  the  engine’s  cooling  system. 


2.2.6.2.2.38  engine_ciog_fuel_fnter 

This  routine  causes  the  fuel  filter  to  be  clogged  and  degrades  the  engine  power 
proportionally. 


2.2.6.2.2.39  engine_replace_fuel_f liter 

This  routine  replaces  the  fuel  filter  and  causes  the  available  power  to  be  increased. 
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2. 2. 6. 2. 3  inl_tracks.c 

(./simn^release/src/vehicle/ml/src/ml_tracks.c  [ml_tracks.c]) 

The  tracks  and  hull  dynamics  arc  simulated  in  this  module.  Torque  from  the  differential  is 
sent  to  both  tracks  which  accelerate  and  rotate  the  tank.  Frictional  forces  arc  computed  for 
traction  behavior.  Failure  modes  simulated  are  thrown  tracks.  The  simulation  routines  arc 
called  from  ml_dtrain.c,  and  the  failure  routines  from  ml_failure.c.  These  routines  arc 
contained  within  the  CSU  ml_tracks.c. 

This  file  consists  of  the  Ml  track  simulation  module.  It  includes  the  terrain  slippage  and 
interaction  model.  It  also  includes  the  bigwheel  algorithm  to  compute  the  vehicle's  support 
plane. 

Includes: 

"stdio.h" 

"math.h" 

"sim_dfns.h" 

"sim_macros.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgLstdg.h" 

"sim_cig_if.h" 

"pro_data.h" 

"libterrain.h" 

"libkin.h" 

"libsusp.h" 

"libfail.h" 

"failurc.h" 

"libhulLh" 

"bigwheel.h" 

"veh_appear.h" 

"libfailh" 

"libsound.h" 

"ml_dtrain.h" 

"ml_meter.h" 

"ml_repair.h" 

"ml_sound.h" 

"ml_sound_dfn.h" 

"ml_tracks.h" 


Defines: 


TRACKS_DEBUG 

TANK.WEIGHT 

FWD_DRAG_BUILDUP_SPEED 

rev_drag_buildup_speed 

DRAG_BUILDUP_GAIN 

TRACK_SEPARATION_DISTANCE 

MAX_TRACK_CANT_SIN 

MAX_RCI050_TRACK_SPEED_DIFFERENTIAL 

RCI_250_CONSTANT_DRAG_FORCE 

RCI_250_DRAG_SPEED_COEFnCIENT 

RCI_050_CONSTANT_DRAG_FORCE 

RCl_050_DRAG_SPEED_COEFnCIENT 


lbs 

mph 


meters  (=  112.0  in) 
sin  (22  degrees)  =  40% 
mph 
lbs 

lbs 
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MUCK  DRAG  FORCE 

TeROWN_TRACK_DRAG_FORCE 

A 

•mACK  SELF  REPAIR  TIME 

minutes 

w 

MAX_RATED_TRACK_SPEED 

(mph)  For  purposes  of  sound 

only 

TRACK  THROWN  OFFSET 

meters 

WALL  CLIMBING  HEIGHT 

meters 

SRPROCKET  RADIUS 

feet 

LEVER  ARM 

Meters 

AJ^GLE  LIM 

~9  degrees  .7  m  by  4.5  m 

€SUN_FORCE 

Force  of  firing  the  gun 

Declaratnons: 

niican_track_velocity 

mph 

l<5ft_track:_velocity 

mph 

t%ht_track_velocity 

mph 

ve:hicle_actual_velocity 

mph 

okd_vehicle_actual_velocity 

mph 

ve,hicle_acceleration 

mph 

» 

\«si^hicle_actual_tum_rate 

rad/sec 

M't_track_status 

WORKING  or  BROKEN 

ri|sht_track_status 

WORKING  or  BROKEN 

staiLtype 

RCI-250  or  RCI-50  or  WATER 

skid_sound_counter 

for  skidding  sound 

c»aometer_reading 

elapsed  km 

<»doineter_count 

tenths  of  km 

ehapsed_inileage 

miles  (float) 

mdieage_count 

miles  (int) 

sliip_state 

NO_SLIP  or  SLIPPING 

ground_force 

force  exerted  on  ground  by  treads 

c«.TeIficient_of_friction[2]  [6] 

2  states,  6  soil  types 

aild_track_velocity 

for  slip  calc 

inxnement 

velocity  increment  per  tick 

These  parameters  are  used  to  run-time  initialize  the  bigwheel  library. 

EKar_wheel 

Isrft  wheel 

rijght  wheel 

TRACK  THROWN  OFFSET 

meters 

VA^ALL_CLIMBING_HEIGHT 

meters 

• 

These  parameters  are  used  to  run-time  initialize  the  suspension  library. 

R  OT  WN 

rot  suspension  natural  freq  (rad) 

ROT  ZE'FA 

rotational  suspension  damping  ratio 

SIDE  WN 

side  suspension  natural  freq  (rad) 

SfDE  ZETA 

side  suspension  damping  ratio 

• 
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2 . 2 . 6 . 2 . 3 . 1  tracks_compute_friction_factor 

This  routine  calculates  the  tracks  friction  factor. 


1  Internal  Variables  | 

Internal  Variable 

Where  Tvpedef  Declared 

force 

REAL 

Sim  types. h 

pitch  sin 

REAL 

Sim  types. h 

pitch  cos 

REAL 

Sim  types.h 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

force 

REAL 

friction  force 

I  Calls  1 

Function 

Where  Described 

kinematics  pitch  sin 

Section  2.5.8.5.1 

sort 

Sim  macros. h 

square 

Sim  macros.h 

Table  2.2-313;  tracks_compute_friction_factor  Information. 


2 . 2 . 6 . 2 . 3 . 2  tr  acks_compute_slipping_state 


This  routine  calculates  the  slipping  state. 


I  Internal  Variables  I 

Internal  Variable 

Where  Tvpedef  Declared 

vel  siqn 

int 

Standard 

new  siqn 

int 

Standard 

vel  diff 

REAL 

Sim  types.h 

I  Return  Values  I 

Return  Value 

Type 

Meaning 

slip state 

REAL 

the  slip  state 

I  Calls  I 

Function 

Where  Described 

tracks_computeJriction_forc 

e 

Section  2.2.6.2.3.1 

abs 

Sim  macros.h 

iiau _ 

sim_macros.h 

Table  2.2-314;  tracks_compute_slipping_state  Information. 
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/2 . 2 . 6 . 2 . 3 . 3  tracks_coinpute_gravity_load 

This  function  is  called  by  the  drive  sprocket  to  compute  the  load  force  on  the  sprocket  due 
(to  gravitational  forces.  The  convention  used  is  that  positive  load  forces  oppose  the 
(dilution  of  sprocket  drive  motion  (i.e.  negative  loading  helps,  and  positive  loa^g 
(Opposes). 


1  Internal  Variables  I 

linternal  Variable 

Where  Typedef  Declared 

(Ditch  sin 

REAL 

Sim  types. h 

(Ditch  cos 

REAL 

Sim  types. h 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

fiorce 

REAL 

friction  force 

1  Calls  1 

Function 

Where  Described 

kinematics  pitch  sin 

Section  2.5.8.5.1 

sort 

Sim  macros.h 

tsQuare 

Sim  .macros.h 

Table  2.2-315:  tracks_coinpute_gravity_Ioad  Information. 

2 . 2 . 6 . 2 . 3 . 4  tracks_compute_dragJoad 

'JThis  function  is  called  by  the  drive  sprocket  to  compute  the  load  force  on  the  spr(x:ket  due 
ito  drag  forces.  Since  drag  forces  are  always  in  opposition  to  the  sprocket,  this  function 
\will  always  return  a  positive  value. 


i  Internal  Variables  I 

linternal  Variable 

Where  Typedef  Declared 

(draq  force 

REAL 

sim  types. h 

Ipuildup  speed 

REAL 

Sim  types. h 

I  Return  Values  I 

(Return  Value 

Type 

Meaning 

(dragjorce 

REAL 

The  drag  force  on  the 
sprocket 

I  Errors  I 

I  (Error  Name 

Reason  for  Error 

I  Track  Error 

Unknown  soil  type 

I  Calls  I 

Function 

Where  Described 

.abs 

sim  macros.h 

;square 

Sim  macros.h 

Table  2.2-316:  tracks_compute_dragJoad  Information. 


626 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


2 . 2 . 6 . 2 . 3 . 5  tracks_repair_thrown_tracks 
This  routine  repairs  a  thrown  track. 


1  Calls  1 

Function 

Where  Described 

biowheel  repair  tracks 

Section  2.5.10.10.3 

Table  2.2-317:  tracks_repair_thrown_tracks  Information. 
2 . 2 . 6 . 2 . 3 . 6  tracks__th  row_left_track 
This  routine  throws  the  left  track. 


1  Calls  1 

Function 

Where  Described 

biqwheel  left  track  broken 

Section  2.5.10.10.1 

Table  2.2-318:  tracks_throw_Ieft_track  Information. 
2. 2. 6. 2. 3. 7  tracks_throw_right_track 
This  routine  throws  the  right  track. 


1  Calls  1 

Function 

Where  Described 

biowheel  rioht  track  broken 

Section  2.5.10.10.2 

Table  2.2-319: 

tracks_throw_right_track  Information. 

2. 2. 6. 2. 3. 8  tracks_compute_weight 

This  routine  returns  the  weight  of  the  tank. 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

TANK_WEIGHT 

REAL 

The  weight  of  the  tank 

Table  2.2-320:  tracks_compute_weight  Information. 


2 . 2 . 6 . 2 . 3 . 9  tracks_compute_real_velocity 


This  routine  returns  the  tank’s  velocity. 


I  Return  Values  I 

Return  Value 

Type 

Meaning 

vehicle_actuaLvelooity 

REAL 

The  velocity  of  the  tank 

Table  2.2-321:  tracks_compute_real_velocity  Information. 
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2.2.6.2.3.10  tracks_compute_velocity 


This  routine  returns  the  mean  velocity  of  the  tracks. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

mean_track_velocity 

REAL 

The  mean  velocity  of  the 
tracks 

Table  2.2*322:  tracks_compute_velocity  Information. 


2.2.6.2.3.11  odometer  simul 


This  routine  updates  the  mileage  count  for  the  odometer  each  tick,  informing  the  stochastic 
failures  module  of  the  mileage. 


1  Internal  Variables  | 

Internal  Variable 

Where  Tvoedef  Declared 

new  count 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

abs 

Sim  macros.h 

controls  odometer  pulse 

Section  2.2.2 

Table  2.2*323:  odometer_simul  Information. 


2.2.6.2.3.12  tracks  set  initial  distance  km 


This  routine  sets  the  initial  distance  by  setting  the  odometer  reading  to  distance. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

distance 

REAL 

Sim  types. h 

Table  2.2*324:  tracks_set_initial_distance  Information. 


2.2.6.2.3.13  vehicle_get_elapsed_km 


This  routine  returns  the  elapsed  distance  in  kilometers. 


j  Return  Values  I 

Return  Value 

Meaning 

odometer  reading 

REAL 

elapsed  distance 

Table  2.2*325:  vehicle_get_elapsed_km  Information. 


628 


BBN  Systems  and  Technologies 


Vehicles  CSQ 


2.2.6.2.3.14  tracks  send  velocities 


This  routine  computes  the  velocities  and  sets  the  odometer  accordingly. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

left 

REAL 

sim  types. h 

right 

REAL 

Sim  types. h 

torque 

REAL 

sim  types. h 

Calls 

Function 

Where  Described 

odometer  simul 

Section  2.2.6.2.3.11 

Table  2.2-326:  tracks  send  velocities  Information. 


2.2.6.2.3.15  tracks_stop_dri  vet  rain 

This  routime  stops  the  tank  by  setting  the  velocities  to  zero. 

2.2.6.2.3.16  tracks  init 


This  routine  initializes  the  tracks. 


I  Calls  I 

Function 

Where  Described 

bigwheel  veh  init 

Section  2.5.10 

suspension  params 

Section  2.5.6.5.1 

fail  init  taiiure 

Section  2.5.4.11.2 

Table 

2.2-326:  tracks_init  Information. 

2,2.6.2.3.17  tracks_compute_vehicle_force 

1  Parameters  I 

Parameter 

Where  Typedef  Declared 

force 

REAL 

sim  types.h 

Return  Values 

Return  Value 

Meaning 

force 

REAL 

the  force  exerted  by  friction 

1  Calls  1 

Function 

Where  Described 

tracks_compute_friction_forc 

e 

Section  2.2.6.2.3.1 

Table  2.2-327:  tracks_compute_vehicle_force  Information. 
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2.2.6.2.3.18  conipi»ute_actual_vehicIe_motion 

This  routine  calculates  ahe  motion  of  the  tank  based  on  the  velocities,  load,  and  friction 
force. 


1  Internal  Variables  I 

Internal  Variable 

Type 

Where  Typedef  Declared 

left  mps 

REAL 

Sim  tvpes.h 

riQht  mps 

REAL 

Sim  types. h 

Calls 

Function 

Where  Described 

tracks  stop  drivetrain 

Section  2.2.6.2.3.15 

tracks  compute  qravitv  iload 

Section  2.2.6.2.3.3 

tracs  compute  slippina  .state 

Section  2.2.6  2.3.2 

sound  make  const  souind 

Section  2.1 .3. 1.2 

Sian 

Sim  macros.h 

Table  2.2-328:  compute_actual_vehicle_motion  Information. 


2.2.6.2.3.19  tell  Mnematics 


This  routine  updates  the  position  of  the  vehicle  in  Kinematics. 


1  Internal  Variables  I 

Internal  Variable 

Where  Typedef  Declared 

inc 

REAL 

Sim  types. h 

angle 

REAL 

Sim  types. h 

1  Calls  1 

Function 

Where  Described 

collision  rear  collision 

Section  2.5.10.4.3 

collision  left  collision 

Section  2.5.10.4.1 

collision  right  collision 

Section  2.5.10.4.2 

tracks  stop  drivetrain 

Section  2.2.6.2.3.15 

kinematics  move  vehicle'. 

Section  2.5.8. 7.1 

kinematics  turn  vehicle 

Section  2.5.8.11.1 

check  turning  sounds 

Section  2.2.6.2.3.26 

Tabie  2.2-329:  tell  kinematics  Information. 


2.2.6.2.3.20  get_cmrrent_soil_ty pe 


This  routine  gets  the  soiii  type  of  the  current  position. 


1  Calls  1 

Function 

Where  Described 

terrain  get  terrain  type 

Section  2.5.11.3.1 

Table  2.2-330:  get  current  soil  type  Information. 
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2.2.6.2.3.21  check_for_t  hrown_track 
This  routine  checks  for  thrown  tracks. 


1  Internal  Variables  | 

Internal  Variable 

Where  Tyoedef  Declared 

cant  sin 

REAL 

Sim  types. h 

1  Calls  1 

Function 

Where  Described 

kinematics  cant  sin 

Section  2.5.8.5.3 

fail  break  system 

Section  2.5.4.8.1 

abs 

Sim  macros.h 

Table  2.2-331:  check_for_thrown_track  Information. 


2.2.6.2.3.22  send  track  sound 


This  routine  causes  the  sound  of  the  tracks  to  be  made. 


1  Internal  Variables  | 

Internal  Variable 

Where  Typedef  Declared 

track  sound 

REAL 

Sim  types. h 

track  speed 

REAL 

Sim  types. h 

1  Calls  1 

Function 

Where  Described 

abs 

Sim  macros.h 

min 

Sim  macros.h 

sound  of  tracks 

Section  2.1. 3.2.9 

Table  2,2-332:  sound_of_tracks  Information. 


2.2.6.2.3.23  send_tracks_outputs 


This  routine  sends  tracks  data  output  to  the  appropriate  controls  and  to  the  sound  system. 


1  Calls  1 

Function 

Where  Described 

send  track  sound 

Section  2.2.6.2.3.22 

meter  speed  set 

Section  2.2.2.3.1 

abs 

Sim  macros.h 

suspension  acceleration  is 

Section  2.5.6.3.1 

Table  2.2-333:  send_tracks_outputs  Information. 
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2.2.6.2.3.24  get_dust_cloud 


This  routine  returns  the  appropriate  dust  cloud  index  based  on  soil  type  and  tracks  speed. 


1  Internal  Variables  | 

Internal  Variable 

Where  Tvpedef  Declared 

speed 

REAL 

Sim  types. h 

1  Return  Values  I 

Return  Value 

Meaning 

vehDustCloudNone 

int 

no  dust  cloud 

vehDustCloudSmall 

int 

small  dust  cloud 

vehDustCloudMedium 

int 

medium  dust  cloud 

vehOustCloudLarge 

int 

large  dust  cloud 

1  Calls  1 

Function 

Where  Described 

terrain  qet  terrain  type 

Section  2.5.11.3.1 

Table  2.2-334:  get_dust_cloud  Information. 


2.2.6.2.3.25  tracks  simul 


This  routine  simulates  the  tracks. 


1  Calls  1 

Function 

Where  Described 

get  current  soil  type 

Section  2.2.6.2.3.20 

check  for  thrown  track 

Section  2.2.6.2.3.21 

compute_actuaLvehicle_moti 

on 

Section  2.2.6.2.3.18 

tell  kinematics 

Section  2.2.6.2.3.19 

send  tracks  outputs 

Section  2.2.6.2.3.23 

network  set  dust  cloud 

Section  2.1.1.3.1.12.1 

tracks  get  dust  cloud 

Section  2.2.6.2.3.24 

Table  2.2-335:  send_tracks_outputs  Information. 


2.2.6.2.3.26  tracks_motion_disabled 

This  routine  returns  TRUE  if  the  tracks  are  disabled  and  returns  FALSE  otherwise. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

TRUE 

BOOLEAN 

tracks  disabled 

FALSE 

BOOLEAN 

tracks  not  disabled 

Table  2.2-336:  tracks  motion  disabled  Information. 


I 
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2.2.6.2.3.27  check_turning_sounds 

This  routine  is  called  by  tracks  to  see  if  the  sound  of  the  vehicle  turning  should  be  started  or 
stopped. 


Parameters 


Parameter 


e 


11113 


e 


REAL 


Internal  Variable 


Sian  old  dir 


Sian  turn  dir 


clamoed  anale 


Internal  Variables 


e 


int 


ini 


REAL 


Where  Typedef  Declared 


sim  tvoes-h 


Where  Tvoedef  Defined 


Standard 


Standard 


sim  tvoes.h 


Calls 

Function 

Where  Described 

sound_make_const_sound 

Section  2.1. 3.1. 2 

Table  2.2-337:  check_turning_sounds  Information. 
2.2.6.2.3.28  tracks  return  slip  state 

This  routine  returns  the  slip  :*ate  of  the  vehicle. 


Return  Value 

Type 

Meaning 

slip_state 

int 

the  slip  state  of  the  vehicle 

Table  2.2-338;  tracks_return_slip_state  Information. 
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2. 2. 6. 3  Vehicle  Sfubsystems 

The  CSU’s  which  provide  this  functionality  are  as  follows: 

ml_elecsys.c 

ml_hydrsys.c 

ml_vision.c 


2. 2. 6. 4.1  inl_elec5sys.c 

(./simne^relea.*se/src/vehicle/ml/src/ml_elecsys.c  [ml_elecsys.c]) 

The  model  of  the  Ml's  ekactrical  system  is  based  the  assumption  that  charge  and  voltage  are 
linearly  related  and  that  tftie  battery  charges  linearly  over  time.  While  many  small 
components  (such  as  indicator  lamps)  consume  electrical  charge,  only  the  major  charge 
consumers  are  modeled.  They  consist  of  the  starter,  laser  range  finder,  auxiliary  hydraulic 
pump,  radio,  and  intercom  for  the  Ml. 

When  the  engine  is  runnimS,  it  is  assumed  that  all  electrical  components  are  obtaining 
electrical  charge  for  the  alkemator/generator,  which  is  modeled  as  an  infinite  amount  of 
charge.  As  long  as  the  engine  is  running  and  the  alternator/  generator  has  not  failed,  all 
requests  for  electrical  charge  are  granted.  The  altemator/generator  will  also  charge  up  a 
battery  which  is  less  thaa  fully  charged.  However,  if  the  engine  is  off  or  the 
altemator/generator  has  fasiled,  the  electrical  components  must  obtain  electrical  charge  from 
the  battery. 

Each  of  the  modeled  electrical  components  requires  a  specific  amount  of  electrical  charge. 
When  the  component  is  u»5d,  the  electrical  system  is  queried  to  see  if  there  is  enough 
charge  present  to  accomirssodate  the  request.  If  so,  the  stored  charge  is  depleted  by  the 
amount  requested. 

Additional  assumptions: 

If  voltage  is  less  cfean  18  v,  the  engine  will  not  start. 

If  voltage  is  less  ttian  23  v,  the  low  battery  charge  light  turns  on. 

The  battery  takes  1 5  minutes  to  charge  from  23v  to  24v. 

Each  time  througfei  the  loop,  1/15  of  a  sec  elapses. 

The  following  assumptions  are  made  for  calculating  the  amount  by  which  the  batteiy  is 
discharged  by  parts  whiefo  are  not  always  using  electricity  (starter,  laser,  pump)  at  the  time 
of  call.  It  is  determined,  whether  or  not  there  is  enough  charge  left  in  the  battery  and 
returns  TRUE  or  FALSE..  Then  a  timer  is  set  up  to  linearly  discharge  the  battery  over  the 
amount  of  time  it  would  rr  ormally  take. 

Due  to  use  of  the  starter 

-  it  takes  1  second  to  star 

-  STARTER_DISCHARGE_DELTA  amp-hours  are  used  up  over  the  1  sec 

-  the  battery  is  discharged  linearly 

-  the  starter  is  allowed  to  function  40  times  (not  including  recharging) 
before  the  abort  ilieht  comes  on. 

-  STARTER_DISCHARGH_DELTA  =  74  amphours/  NUMBER  OF  TIMES  (40) 

-  calculations:  15  frames/sec  12  1  sec  =  15  frames 

1.85  arnp-honrs  / 15  frame  ;  .12333333333  amp-hours/frame 
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Due  to  use  of  the  auxiliaiy  pump: 

-  a  1  hp  pump  (not  an  assumption),  1  hp  =  746  watts 

-  power  =  vi  ->  current  =  746  watts/24  volts 

-  i  =  dq/dt 

-  dt  =  1/15  sec/frame  *  1/60  min/sec  *  1/60  hr/min  =  1/54000  hr/frame 

-  dq  =  746/24  *  1/54000  =  373/648(X)0  amp-hr/frame  for  linear  discharge 

Due  to  use  of  the  radio: 

-  the  radio  can  be  used  for  20  hours  before  the  engine  can  no  longer  start 
(battery  discharged  by  75  amp-hr) 

-  the  radio  is  always  on  if  master  power  is  on 

-  the  radio  uses  3.75  amp-hr/hr 

-  3.75  amp-hr/hr  *  1/60  hr/min  *  1/60  min/sec  *  1/15  sec/frame 

-  dq  =  3.75/54000  amp-hr/frame,  assuming  linear  discharge 

Due  to  use  of  the  intercom: 

-  the  intercom  lasts  15  hours  before  the  engine  can  no  longer  start 
(battery  discharged  by  75  amp-hrs) 

-  the  intercom  is  ^ways  on  if  master  power  is  on 

-  75  amp-hours/15  hours  *  1/3600  hr/sec  =  5/3600  =  1/720  amp-hr/sec 

-  dq  =  1/15  sec/fr  *  1/720  amp-hr/sec  =  1/10800  amp-hr/fr 
discharged  linearly 

Due  to  use  of  the  laser  range  finder: 

-  the  laser  range  finder  can  be  fired  1(X)  times  before  the  engine  will  not  start 
(discharged  75  amphr) 

-  75  /  100  =  .75  amp  -  hr  used  each  time  the  laser  range  finder  is  charged  up 

The  following  assumptions  are  used  to  deteratine  the  voltage  shown  on  the  voltmeter  when 
the  engine  is  on: 

-  voltage  put  out  by  the  alternator  is  27.5  to  28.5  volts 

-  rpms :  low  idle  -  900 

tac  idle  - 1313 
max  idle  -  31(X) 

-  assume  900  to  3100  corresponds  piecewise  linearly  to  27.5  to  28.5  volts 

-  When  driving,  rpm  is  generally  between  900  and  2000  rpms,  therefore  the 
range  of  volts  is  27.5  to  28.2  volts 

-  From  2000  to  3100  rpms,  the  range  of  volts  will  be  28.2  to  28.5  volts 

The  following  assumptions  are  used  to  detemune  the  voltage  shown  on  the  voltmeter  when 
the  engine  is  on,  but  the  alternator  is  broken: 

-  The  engine  runs  off  the  battery  for  5  minutes.  Then  the  battery  drops  to  the 
WEAKLY_CHARGED  state.. 

-  The  engine  rans  for  5  minutes  and  then  stops. 

(battery  discharged  by  75  amp-hrs) 

-  The  intercom  is  always  on  if  master  power  is  on 

-  75  amp-hours/(l/12)  hours  *  1/3600  hr/sec  =  1/4  amp-hr/sec 

-  dq  =  1/15  sec/fr  *  1/4  amp-hr/sec  =  1/60  amp-hr/fr,  discharged  linearly 

The  following  assumptions  are  used  to  determine  the  rate  for  charging  the  battery: 

-  If  battery  drops  from  24v  to  23v,  it  takes  15  minutes  with  the  engine  running  to 
recharge  it  back  to  24  volts.  (0.25  hr/volt) 

-  Assume  the  recharge  curve  is  linear 

-  (engine  should  have  low  crank  speed  if  battery  <=  23,  note  that  no  sound  models 
this  right  now) 
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- 15  frames/sec  *  60  sec/min  *  15  min  =  13500  frames  to  recharge  Iv 
-  lvolt/13500  frames  =  7.407407e-5  volts/frame 
- 15  frames/sec  *  60  sec/min  *  3  min  =  2700  frames 
- 1  volt/2700  frames  =  .000370370370  volts/frame 

The  following  define  the  amount  by  which  the  battery  is  discharged  when  called: 
STARTER_DISCHARGE_DELTA 
LASER_DISCHARGE_DELTA 
AUX_PUMP_DISCHARGE_DELTA 

The  following  define  the  amount  by  which  the  battery  is  discharged  each  tick  under  correct 
conditions: 

STARTER_DISCHARGE_RATE 

RADIO_DISCHARGE_RATE 

INTERCX)M_DISCHARGE_RATE 

ENGINE_DISCHARGE_RATE 

BATrERY_RECHARGE_RATE 

The  following  define  the  battery  recharge  rate: 

BATTERY.RECHARGE.RATE 

STARTER_DURATION 

The  following  define  constants  used  to  determine  the  voltage  of  the  alternator: 

LOW_IDLE 

TAC.BDLE 

MAX_IDLE 

MAX_ALTERNATOR_VOLTAGE 

MIN_ALTERNATOR_VOLTAGE 

The  following  define  states  of  the  battery  in  units  of  charge: 

FULLY.CHARGED 

MEDIUM_CHARGED  -  the  battery  low  light  will  turn  on. 
WEAKLY_CHARGED  -  laser,  starter,  and  auxiliary  pump  are  dead. 
BATlERY_DEAD  -  all  lamps  are  off 

LOWEST_BATTERY_VOLTAGE  -  lowest  reading  on  voltmeter. 
MAX_CHARGE  -  maximum  charge  held  in  battery 

MAX_VOLTAGE  -  maximum  voltage  of  battery 

The  following  conversion  factors  are  defined: 

V_TO_Q  -  voltage  to  charge 

Q_TO_V  -  charge  to  voltage 

The  following  constants  for  rpms  to  volts  conversion  are  defined: 

Ml  -  slope  of  first  part  of  line 

M2  -  slope  of  second  part  of  line 

VERTEX  -  point  where  slopes  change 

The  following  BOOLEAN  values  for  state  of  the  battery  are  defined: 

NEW 

LEAKY  -  leaky  batteries  charge  up  but  hold  no  charge  when  a 

load  is  applied. 
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The  following  are  declared: 
batteiy_charge 
batteiy_voltage 
starter_timer_id 
starter_timer_status 
electsys_status 
power_status 
battery_status 
altemator_status 


-  current  charge  in  battery 

-  current  battery  voltage 

-  holds  id  returned  by  timer 

-  indicates  if  timer  is  on 

-  indicates  if  electrical  system  is  on 

-  indicates  if  master  or  turret  power  is  on 
-LEAKY  or  NEW 

-  if  BROKEN,  use  battery 


electsys_discharge_battery(); 

electsys”charge_battery(); 

electsys~rpms_to_volts(); 

electsys~handle_le^aky_battery(); 


Includes: 

"stdio.h" 

"sim_dfns.h" 

"timers.h" 

"timers_dfn.h" 

"libfaiLh" 

"failure.h" 

"ml_engine.h" 

"ml.cntrl.h" 

"ml_meter.h" 


Defines: 

ELECTSYS_DEBUG 


2. 2. 6. 3. 1.1  electsys_simul 

This  is  the  primary  routine  in  this  module.  If  the  engine  is  running  and  alternator  status  is 
true,  then  the  engine  is  running  off  the  alternator  rather  than  the  battery.  When  the  engine 
is  running  with  the  alternator,  the  battery  is  recharged.  The  battery  discharges  when  the 
engine  is  running  off  the  battery  and  when  the  engine  is  off.  Assume  that  if  asked  for  the 
battery  usage,  either  the  engine  is  on  or  the  master  power  is  on. 


1  Calls  1 

1  Function 

Where  Described 

Section  2.2.6.2.2.8 

meter  volt  set 

Section  2.2.2 

electsys  rpms  to  volts 

Section  2.2.6.3.1.6 

electsvs.  charge  battery 

Section  2.2.6.3.1.3 

electsys_discharge_hulLbatt 

ery 

Section  2.2.6.3.1.7 

controls  low  charge  off 

Section  2.2.2 

engine,  shutoff  switch 

Section  2.2.6.2.2.20 

timers  get  ticking  status 

Section  2.6.3.20.1 

timers  free  timer 

Section  2.6.3.5.1 

Table  2.2-339:  electsys_simul  Information. 
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2. 2. 6. 3. 1.2  electsys_dead 

This  routine  calfcs  a  routine  which  sets  the  electrical  system  to  the  inactive  state. 


Function 


controls  electsysF  dead 


Calls 


Where  Described 


Section  2.2.2 


Table  2.2-340:  electsys_dead  Information. 


2 . 2 . 6 . 3 . 1 .3  electsy  s_cha  rge_battery 
This  routine  recharges  the  tank's  battery. 

2 .2 . 6 . 3 . 1 .4  electsys_power_request 

This  routine  is  oi^ed  by  the  controls  routines  to  check  that  power  can  be  turned  on. 


Return  Value 


WORKING 


Return  Values 


Type  _ 


BOOLEAN 


Meanin 


can  turn  power  on 


Table  2.2-341:  eIectsys_power_request  Information. 


2. 2. 6. 3. 1.5  electsys_power_off 
This  routine  sefcb  the  power  status  to  OFF. 
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2. 2. 6. 3. 1.6  electsys_rpms_to_volts 

This  routine  allows  the  electrical  system  meter  to  reflect  the  change  in  rpms  of  the  engine. 
This  routine  is  only  called  while  the  engine  is  on.  This  is  accomplished  by  the  y  =  mx  +  b 
formula  where  y  is  volts  and  x  is  rpms.  The  y  values  range  from  27.5  volts  to  28.5  volts 
while  the  x  values  range  from  900  rpms  to  3100  rpms.  The  volts  map  to  rpms  using  the 
following  formula: 

volts  =  1/2200  (rpms  -  9(X))  +  27.5 
The  ranges  are  as  follws: 

rpms  volts 

<  900  27.5 

900  -  2000  27.5  -28.2 

2000-3100  28.2-28.5 
>3100  28.5 

_  Internal  Variables  _ 

Internal  Variable _ Type _ Where  Typedef  Declared 

rpms_ REAL_ sim  types.h 


Return  Values 


Return  Value 

Type 

Meaning 

MIN  ALTERNATOR  VOLTA 
GE 

REAL 

the  minimum  alternator  voltage 

MAX  ALTERNATOR  VOLTA 
GE 

REAL 

maximum  alternator  voltage 

M1*(rpms-900)+27.5 

REAL 

voltage  for  rpms  between  900 
and  2000 

M2*(rpms-3l00)+28.5 

REAL 

voltage  for  rpms  between 

2000  and  3100 

_ _ Calls 

Function  Where  Described 

engine  get  speed _ Section  2.2.6.2.2.11 
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2 . 2 . 6 . 3 . 1 . 8  electsys_engine_start_request 

This  routine  deteniiines  if  the  batteiy  is  sufficiently  charged  for  the  engine  to  be  started. 

_ _ Return  Values  _ 

Return  Value  jType  [Meaning 

TRUE _ BOOLEAN _ engine  can  be  started 

FALSE  BOOLEAN_ engine  cannot  be  started 


_ _ Calls _ 

Function _ Where  Described _ 

elecsys_handle_leaky_batter  Section  2.2.6.3.1.16 

1 _ 

timers  free  timer _ Section  2.6.3.5.1 _ 

timers  get,  timer  Section  2. 6.3.6. 1 

Table  2.2-344:  electsys_engine_start_request  Information. 


2 . 2 . 6 . 3 . 1 . 9  electsys_aux_pump_request 

This  routine  determines  if  the  battery  is  sufficiently  charged  for  the  auxiliary  pump  to  be 
operated. 

_ _ Return  Values _ _ 

Return  Value  [Type  [Meaning 

TRUE _ BOOLEAN _  pump  can  be  operated 

FALSE  BOOLEAN_ pump  cannot  be  operated 


_ _ Calls 

Function  I  Where  Described 
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2.2.6.3.1.10  electsysjaser_start_request 

This  routine  determines  if  there  is  enough  battery  power  to  operate  the  laser  range  finder. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

TRUE 

BOOLEAN 

laser  can  be  operated 

FALSE 

BOOLEAN 

iaser  cannot  be  operated 

1  Calls  1 

Function 

Where  Described 

elecsys_handle_leaky_batter 

1 

Section  2.2.6.3.1.16 

Section  2.2.6.2.2.8 

1  elecsys.  discharqe.battery 

Section  2.2.6.3.1.7 

Table  2.2-346:  electsys_Iaser_start_request  Information. 


2.2.6.3.1.11  eiectsys_get_battery_voltage 


This  routine  returns  the  battery  voltage. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

battery_voltage 

REAL 

the  battery  voltage 

Table  2.2-347:  eIectsys_get_battery_voltage  Information. 


2.2.6.3.1.12  eIectsys_replace_aIternator 

This  routine  repairs  the  alternator  by  setting  alternator  status  to  WORKING. 


2.2.6.3.1.13  electsys_alternator_failure 

This  routine  causes  the  alternator  to  fail  by  setting  alternator  status  to  BROKEN.  When 
the  alternator  fails,  the  engine  runs  off  the  battery. 
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2.2. 6.3.1.  M  4  electsys_recharge_battery 

This  roudae  j: recharges  the  battery.  The  battery  voltage  returns  to  24.0  volts. 


Function 


hydraulic  Cbaarae  reborn 


controls  ela«.r5  reborn 


controls  tow  cy^iaroe  off 


Calls 


Where  Described 


Section  2.2.6.4.2.20 


Section  2.2.2 


Section  2.2.2 


TTable  2JK-348:  electsys_recharge_battery  Information. 

2.2.6.3.1.115  electsys_replace_ba ttery 

This  routine  r replaces  a  leaky  battery,  battery  status  is  set  to  NEW. 


Function 


electsys  recfea^i^ae  batte 


Calls 


Where  Described 


Section  2.2.6.3.1.14 


ITable  2.2-349:  electsys_replace_battery  Information. 


2 . 2 . 6 . 3 .1. 11 6  electsys_handle_leaky_battery 

This  routine  brandies  the  case  of  a  leaky  battery.  A  load  is  applied  across  a  leaky  battery. 
Although  the  l;3attety  will  charge,  the  voltage  will  drop  to  WEAKLY_CHARGED  once  the 
load  has  bcenii  applied.  The  low  battery  charge  light  is  turned  on. 


Function 


controls  tom  tivnarqe  on 


Calls 


Where  Described 


Section  2.2.2 


Tai^e  2.2-350;  electsys_handle_leaky_battery  Information. 


2.2.6.3.1.11 7  electsys_battery_failure 

This  routine  c  lauses  the  battery  to  become  leaky  by  setting  battery  status  to  LEAKY. 

2. 2. 6. 3. 1.1a 8  electsys_vars_status 

This  routine  {prints  the  values  of  the  following  variables.  It  is  used  as  a  debugging  tool. 

baOerjT  charge 
batter  Jr  voltage 
starter  jimer  id 
stanei  jiimr  jtatm 
eleasy^s  statm 
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2.2.6.3.1.19  electsys_init 

This  routine  initializes  the  electrical  system  for  operation. 


1  Calls  1 

Function 

Where  Described 

meter  volt  set 

Section  2.2.2 

fail  Init  failure 

Section  2.5.4.11.2 

Table  2.2-351;  electsys_init  Information. 
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2. 2. 6. 4. 2  inl_hydrsys.c 

(./simnetA'elease/src/vehicle/ml/src/ml_hydrsys.c  [hydraulics_simul]) 


The  routines  used  to  model  the  Ml’s  hydraulic  system  are  found  in  one  CSU, 
ml_hydrsys.c.  As  with  the  electrical  system  model,  only  specified  components  actually 
operate  using  hydraulic  pressure  in  this  model.  They  are  the  traversing  of  the  turret, 
elevation  of  the  gun,  opening  and  closing  of  the  ammo  door,  and  setting  of  the  parking 
brake.  For  the  ammo  door  and  parking  brake,  a  discrete  amount  of  hydraulic  pressure  is 
depleted  firom  the  hydraulic  reservoir  each  time  the  component  is  accessed.  For  the  turret 
and  gun,  hydraulic  pressure  is  depleted  from  the  reservoir  every  frame  that  the  turret  is 
traversing  or  the  gun  is  elevating  or  depressing.  The  exact  amount  depends  how  quickly 
the  turret  or  gun  is  moving.  If  the  pressure  in  the  reservoir  falls  below  specified  levels,  the 
query  to  the  hydraulic  system  will  fail  and  the  component  will  fail  to  operate  properly. 

The  model  has  both  a  main  hydraulic  pump  and  an  auxiliary  hydraulic  pump.  When  the 
engine  is  running,  the  main  pump  is  operational,  and  it  is  more  than  sufficient  to  meet  all 
the  hydraulic  ne^s  of  the  vehicle.  Therefore,  the  vehicle  responds  as  though  it  has  an 
infinite  supply  of  hydraulic  pressure  because  the  reservoir  is  being  replenished  as  quickly 
as  it  is  being  depleted.  When  the  engine  if  off,  however,  the  auxiliary  hydraulic  pump  is 
used  to  replenish  the  reservoir.  It  does  not  accomplish  this  as  quickly  as  the  main  pump 
does  so  hydraulic  pressure  may  run  out.  If  the  pressure  drops  too  low,  the  operator  must 
wait  for  the  pressure  to  build  up  again  before  using  any  components  requiring  hydraulic 
pressure. 


The  hydraulic  system  is  modelled  as  a  capacitor.  Pressure  (psi)  is  modelled  as  volts,  flow 
(gpms)  is  modeUed  as  current,  hydraulic  const  (gal-sec/psi-min)  is  modelled  as  capacitance 
(farads).  The  following  information  is  used  to  calculate  the  hy^aulic  constant : 

-  whether  using  the  auxiliary  pump 

-  turret  traversd  impossible  when  hydraulic  pressure  <  900  psi. 

-  with  pressure  at  15(X)  psi,  turret  may  be  slewed  for  6.0  seconds  (turned  150 
degrees)  before  pressure  becomes  too  low. 

-  takes  45  seconds  for  hydraulic  pressure  to  go  from  500  -  1500  psi. 

-  K  *  1(XX)  psi/45  seconds  =  5  gWmin;  K  =  .225  gal-sec/psi-min. 

-  K  =  0.00375  gal/psi 

-  flow  from  hydraulic  reservoir  =  K  *  (1500  -  900)  psi/6.0  sec. 

flow  =  22.5  gal/min  when  slewing  the  turret,  but  will  use  these  values  for  other 
operations  (vdue  is  for  full  handle  displacement). 

-  22.5  gal/min  *  1/60  miiysec  *  1/15  sec/frame  =  0.025  gal/frame 

-  to  calculate  max  reduction  of  psi/frame  of  the  reservoir,  use 
FLOW_OUT_RATE  =  0.025  gal/fi-ame. 

-  flow  =  K  *  dp/dt  ->  dp  =  flow  /K  *  dt;  where  dt  =  1  frame 

-  dp  =  0.025  gal/frame  /  0.00375  gal/psi  *  1  frame  =  6.66666667  psi 

-  system  is  modelled  with  only  one  accumulator  containing  800  psi 

-  regulator  drops  1(X)  psi,  so  hydraulic  reservoir  must  hold  at  least  900  psi  for 
consistent  operation. 


Tlie  following  constants  associated  with  the  hydraulic  model  are  defined: 
HYDR.OONST  in  gal/psi 

MAX_FLOW_OUT_RATE  in  gal/frame 

MAX_PSI_FLOW  OUT  in  psi/frame 

OPERATIONAL.SPEED  in  rpms 

Tht;  range  of  tlie  main  pump  is  1550  -  17(X)  psi 
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-  Pump  turns  on  if  hydraulic  reservoir  drops  below  1550  psi 

-  Pump  turns  off  if  hydraulic  reservoir  exceeds  1700  psi 

-  For  normal  hydrauUc  system  operation,  flow  rate  is;27.1  gpm  if  engine  is  idle, 
47.4  gpm  if  engine  is  at  operational  speeds. 

-flow  =  Kdp/dt 

-  27.1  gal/min  =  HYDR_CONST  *  dp/1  frame 

dp/fr  =  27. 1  gal/min  /  0.00375  gal/psi  *  min/60  sec  *  sec/15  frame 
=  8.0296296296296  psi/frame 

-  if  flow  =  47.4  gpm,  dp/fr  ->  1 4.04 '14'1^'1'144<1'1'1  <1444  psi/frame 
The  following  constants  associated  with  the  engine  are  defined: 

ENGINE_IDLE_PSI_IN_RATE  in  psi/fi'ame 

ENGINE_OPER_PSI_IN_RATE  in  psi/fame 

The  range  of  the  auxiliary  pump  is  1 150  -  1650  psi 

-  Pump  turns  on  if  hydraulic  reservoir  drops  below  1150  psi 

-  Pump  turns  off  if  hydraulic  reservoir  exceeds  1650  psi 

-  max  flow  rate  is  5  gpm 
The  following  constant  is  defmed: 

ENGINE_OFF_PSI_IN_RATE  in  psi/frame 

This  code  models  the  actual  Ml  accurately  by  including  an  accumulator  and  a  regulator 
(although  they  are  not  necessary  for  this  code).  The  following  constants  are  associated 
with  the  accumulator: 

REGULATOR  in  psi 

ACC_PRESSURE_MAX  in  psi 

ACC_WORKING_THRESHOLD  in  psi 

MAIN_PUMP_ON_VAL  in  psi 

MAIN_PUMP_OFF_VAL  in  psi 

AUX_PUMP_ON_VAL  in  psi 

AUX_PUMP_OFF_VAL  in  psi 

RESERVOIR_MIN  in  psi 

The  following  are  defined  for  use  in  this  modeule: 

YES 
NO 

RUN_LIMIT 
STOP_LIMIT 
HYDRAULIC_VERBOSE 
OPEN 
CLOSED 
MAIN 
AUX 

The  following  constants  are  associated  with 
AMMO_DOOR_OPEN_DELTA 
AMMO_DOOR_DELTA 
AMMO_DOOR_CLOSED_DELTA 
AMMO_DOOR_LIMIT 

The  following  constants  are  associated  with 
PARKING_BRAKE_DELTA 
PARKING_BRAKE_LIMIT 


if  counter  <  7,  slew 
if  7  >  ctr  <  16,  stop 


the  ammo  door: 
in  psi 

in  psi,  while  door  is  open 
in  psi 
in  psi 

the  parking  brake: 
in  psi 
in  psi 
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The  following  variables  are  declared  for  use  in  this  module: 


mam jjumpstatus 
aux j)umpjitatm 
acc 

reservoir 

hydraulic 

ammo  door  status 
master _power  status 
enoughcharge 
slew Jerk_ctr 
elev Jerkctr 


working  or  broken 

-  working  or  broken 

-  assume  using  one  main  accumulator,  keeps  track  of 
pressure  in  accumulator 

-  amount  of  pressure  hydraulic  reservoir 

-  tells  if  a  hydraulic  pump  is  gone 

-  tells  if  door  is  OPEN  or  CLOSED 

-  tells  if  master  power  is  ON  or  OFTF 

-  tells  if  battery  had  enough  charge  last  time 

-  allows  for  jerking  during  turret  slew  if  pressure  is  too  low 

-  allows  for  jerking  during  turret  elevation  if  the  pressure  is 

too  low 


The  following  routines  are  declared: 

hydraulic_main_pump  fill  () 
hydraulic~aux_pump_Rll  () 
hydraulic_delta_pressure_calc  () 
hydraulic~check_acc  () 
hydraulic_fraction_flow_rate  () 
hydraulic_deplete_reservoir  () 

The  following  arc  included: 

"stdio.h" 

"sim_dfns.h" 

"sim_types.h" 

"libsound.h" 

"ml_elecsys.h" 

"ml_engine.h" 

"ml_sound_dfn.h" 


2. 2. 6. 4. 2.1  hydraulic_simul 

This  routine  simulates  the  tanks  hydraulic  system  using  the  model  described  above. 


1  Calls  1 

Function 

Where  Described 

enaine  runninq 

Section  2.2.6.2.2  6 

hydraulic  main  pump  fill 

Section  2.2.6.4.2.5 

hydraulic  aux  pump  fill 

Section  2.2.6.4.2.6 

sound  make  const  sound 

Section  2. 1.3. 1.2 

Table  2.2-352:  hydraulic_simul  Information. 
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2. 2. 6. 4. 2. 2  hydraulic_init 

This  routine  initializes  the  hydraulic  system.  It  sets  the  following  variables  to  their  initial 
values: 


reservoir  AUX_PUMP_OFF_VAL 

acc  ACC_PRESSIJRE_MAX 

ammo  door  status  CLOSED 

master _power  status  OFF 

hydraulic  OFF 

enoughjcharge  TRUE 

main _pump  status  WORKING 

aux  pump  status  WORKING 


2. 2. 6. 4. 2. 3  hydraulic_check_acc 

This  routine  regulates  the  contents  of  the  accumulator. 


2 . 2 . 6 . 4 . 2 .4  hydraulic_deplete_reservoir 

This  routine  decrements  the  hydraulic  resevoir  by  delta  psi. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

delta 

REAL 

Sim  types. h 

Calls 

Function 

Where  Described 

hydraulic  check  acc 

Section  2.2.6  4.2.3 

Table  2.2-353;  hydrauHc_depIete_resevoir  Information. 


2. 2. 6. 4. 2. 5  hydraunc_main_pump_f1Il 

This  routine  is  used  to  refill  the  hydraulic  reservoir  using  the  main  hydraulic  pump.  It 
increments  the  reservoir  by  the  appropriate  pressure  (psi)  per  frame.  The  increment 
depends  on  whether  or  not  the  engine  is  at  operation^  speed. 


1  Calls  1 

Function 

Where  Described 

hydraulic  check  acc 

Section  2.2.6.4.2.3 

enqine  aet  speed 

Section  2.2.6.2.2.11 

Table  2.2-354:  hydraulic_aux_pump_fill  Information. 
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2. 2. 6. 4. 2. 6  hydraulic_aux_pump_fill 

This  routine  is  used  to  refill  the  hydraulic  reservoir  using  the  auxiliary  hydraulic  pump.  It 
increments  the  hydraulic  pressure  by  the  appropriate  psi/frame.  enough  charge  keeps  track 
of  whether  or  not  there  was  enough  battery  charge  at  the  last  request.  If 
enough  charge  =  0,  there  must  be  a  call  from  the  electrical  system  letting  the  hydraulic 
system  know  the  battery  has  been  recharged. 


1  calls  1 

Function 

Where  Described 

hydraulic  check  acc 

Section  2.2.6.4.2.3 

electsvs  aux  pump  request 

Section  2. 2. 6.3. 1.9 

Table  2.2-355:  hydraulic_aux_pump_fill  Information. 


2 . 2 . 6 . 4 . 2 . 7  hydrauIic_ammo_door_open_request 


Each  time  the  ammo  door  is  opened,  2.4  psi  is  decremented  from  the  reservoir,  and  0.1  psi 
is  depleted  Irom  the  reservoir  each  tick  if  the  door  is  left  open.  After  the  accumulator  has 
dropped  below  750  psi,  the  ammo  door  will  not  work. 


I  Return  Values  I 

Return  Value 

Type 

Meaning 

FALSE 

BOOLEAN 

ammo  door  can’t  open 

TRUE 

BOOLEAN 

ammo  door  can  open 

Calls 

Function 

Where  Described 

hydraulic,  deplete  reservoir 

Section  2. 2. 6. 4. 2.4 

Table  2.2-356:  hydraulic_ammo_door_open_request  Information. 


2. 2. 6. 4. 2. 8  hydraulic_ammo_door_closed 


The  ammo  door  is  closed  by  setting  ammo_door_status  to  CLOSED.  Each  time  the  ammo 
door  is  closed,  2.4  psi  is  depleted  from  the  reservoir. 


I  Calls  I 

Function 

Where  Described 

hydraulic  deplete  reservoir 

Section  2.2.6.4.2.4 

Table  2.2-357:  hydrau!ic_ammo_door_closed  Information. 
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2.2.6.4.2.9  hydraulic_parking_brake_on_request 

Each  time  the  parking  brake  is  depressed,  2.5  psi  is  removed  from  the  hydraulic  reservoir, 
even  if  there  is  not  sufficient  pressure  to  stop  the  tank.  If  there  is  less  than  500  psi,  the 
hydraulic  reservoir  fluid  will  not  be  available  and  will  not  be  removed  from  the  reservoir. 
TTie  2.5  psi  is  removed  over  one  frame.  This  routine  returns  TRUE  if  the  brake  can  be 
used  and  FALSE  otherwise. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

FALSE 

BOOLEAN 

parking  brake  cannot  be  used 

TRUE 

BOOLEAN 

parking  brake  can  be  used 

Calls 

Function 

Where  Described 

hydraulic,  deplete  reservoir 

Section  2.2.6.4.2.4 

Table  2.2-358:  hydraulic_amino_door_on_request  Information. 


2.2.6.4.2.10  hydraulic_slew_turret_request 

This  routine  processes  a  turret  slew  request,  fraction  jo  move  is  a  value  between  0  and  1 
and  is  used  to  determine  how  much  of  the  maximum  elevation  rate  the  gun  will  move. 
MAX  speed  coiresponds  to  1.  This  is  used  to  determine  how  much  of  the  22.5  gpm 
maximum  flow  rate  must  be  used  to  drain  pressure  from  the  hydraulic  reservoir.  This 
routine  should  be  called  every  tick  in  which  the  turret  wants  to  move.  This  routine  returns 
YES  if  there  is  sufficient  hydraulic  pressure  for  the  turret  to  move  and  returns  NO 
otherwise. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

fraction  to  move 

REAL 

Sim  types. h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

YES 

BOOLEAN 

turret  can  slew 

NO 

BOOLEAN 

turret  can  not  slew 

1  Calls  1 

Function 

Where  Described 

hydraulic Jraction  flow  rate 

Section  2.2.6.4.2.12 

hydraulic  deplete  reservoir 

Section  2.2.6.4.2.4 

hydraulic_deltaj)ressure_cal 

c 

Section  2.2.6.4.2.13 

Table  2.2-359;  hydraullc_elevate_turret_request  Information. 
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2Lv2. 6.4.2. 11  liydraulic_elevate_gun_request 

TRus  routine  proceaaees  a  gun  elevation  request  fraction  tojnove  is  a  value  between  0  and 
1  tused  to  determine  how  much  of  the  maximum  elevation  rate  the  gun  will  move.  MAX 
spieed  corresponds  m  1.  This  is  used  to  determine  how  much  of  the  22.5  gpm  maximum 
flow  rate  to  use  twtSrain  pressure  from  the  hydraulic  reservoir.  This  routine  should  be 
ca^Oed  every  tick  irr  which  the  gun  wants  to  move.  Assume  that  the  gun  elevation  takes  1/5 
less  hydraulic  pressure  when  elevating  at  MAX  speed  than  it  takes  to  slew  turret  at  MAX 
spceed.  This  routine  returns  YES  if  there  is  sufficient  hydraulic  pressure  for  the  gun  to 
tORDve  and  returns  l^'O  otherwise. 


1  Parameters  | 

Pairameter 

Where  Typedef  Declared 

franction  to  move 

REAL 

Sim  types. h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

YES 

BOOLEAN 

gun  can  elevate 

NO 

BOOLEAN 

gun  cannot  elevate 

1  Calls  1 

Fuinction 

Where  Described 

hydraulic  _fraction_.flc3w  rate 

Section  2.2.6.4.2.12 

hydraulic  deplete  neservoir 

Section  2.2.6.4.2.4 

hydraulic_deltajoressure_cal 

c 

Section  2.2.6.4.2.13 

Table  2.;2-360:  hydraulic_elevate_gun_request  Information. 


2.2.6.4.2.12  hy  drauUc_f raction_flow_rate 


Tbtis  routine  calculates  the  hydraulic  flow  rate  per  frame.  It  returns  a  percentage  of  the 
mmimum  possible  flow  rate  per  frame. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

fraction  to  move 

REAL 

sim  types. h 

Return  Values 

Rtfturn  Value 

Type 

Meaning 

fraction  to  move  *" 

MAX  FLOW  OUT  RATE 

REAL 

hydraulic  flow  rate  per  frame 

Table  2.2-.^51:  hydraulic_delta_pressure_calc  Information. 
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2.2.6.4.2.13  hy draulic_delta_pressurej 


This  routine  calculates  and  returns  the  change  in  pressure  (psi)  of  the  hydraulic  reservoir, 
given  the  flow  rate  per  frame  (flow_rate). 

K  ♦  dp/dt  =  flow/dt 
dp  =  flow/K. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

ftow  rate 

REAL 

Sim  types. h 

Return  Values 

Return  Value 

Type 

Meaning 

flow_rate/HYDR_CONST 

REAL 

the  change  in  pressure  of  the 
hydraulic  reservoir 

Table  2.2-362:  hydraulic_delta_pressure_calc  Information. 

2.2.6.4.2.14  hydrauIic_master_power_on 

This  routine  turns  the  hydraulic  master  power  on  by  setting  master _power_status  to  ON. 

2.2.6.4.2.15  hydraulic_master_power_off 

This  routine  turns  the  hydraulic  master  power  off  by  setting  master  jjowerjtatus  to  OFF. 

2.2.6.4.2.16  hydraulic_repair_main_pump 

This  routine  repairs  the  main  hydraulic  pump  by  setting  main _pump_status  to  WORKING. 

2.2.6.4.2.17  hy draulic_repai r_aux_pump 

This  routine  repairs  the  auxiliary  hydraulic  pump  by  setting  aux  pump  status  to 
WORKING. 

2.2.6.4.2.18  hydraulic_main_pump_faiiure 

This  routine  sets  the  status  of  main _pump_status  to  BROKEN,  causing  the  main  hydraulic 
pump  to  fail.  A  message  is  printed  to  the  standard  output  indicating  that  the  pump  has 
failed. 
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2.2.6.4.2.19  hydraulic_aux_pump_failure 

This  routine  sets  the  status  of  aux  j)ump  status  to  BROKEN,  causing  the  auxiliary 
hydraulic  pump  to  fail.  A  message  is  printed  to  the  standard  output  indicating  that  the 
pump  has  failed. 


2.2.6.4.2.20  hy draulic_cha rge_reborn 

This  routine  is  called  firom  the  electrical  system  routines  to  inform  the  hydraulic  system  that 
the  battery  has  been  recharged. 


2.2.6.4.2.21  hydrsys_vars_status 

This  routine  prints  the  value  of  the  following  variables: 
hydr^ic 
resevoir 

ammo  door  status 
slew Jerkctr 
elev jerkctr 
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2. 2. 6. 4. 3  ml_vision.c 

(./simnet/release/src/vehicle/ml/src/ml_vision.c  [ml_vision.c]) 

The  file,  ml_vision.c  contains  routines  to  break  the  viewports  (turn  them  off)  and  fix  them 
by  toggling  bits  in  libvflags.  In  addition,  ml_vision.c  contains  routines  to  switch  between 
thermal  and  out  the  window  views  for  CATC  training.  There  routines  only  affect 
simulators  which  have  the  proper  hardware  modifications  to  do  thermal  switching.  The 
ability  of  the  cupolas  to  pitch  up  and  down  is  also  controlled  in  the  vision  files. 

Includes: 

"stdio.h" 

"math.h" 

"sim_types.h" 

"sim_dfns.h" 

"libfaiLh" 

"failure.h" 

"mass_stdc.h" 

"libvflags.h" 

"ml_vision.h" 


Defines: 

View  Flags 

DVRS_LT 

DVRS  CTR 

DVRS_RT 

CMDR.LT 

CMDR_CTR 

CMDR.RT 

CMDRS.VIEWP 

DVRS_VIEWP 

LDR.VIEWP 

GNR_VIEWP 

CMDR_PITCH_BR_VAL 

LMR_PITCH_BR_VAL 

CMDR_BIN_BR_VAL 

Configuration  Viewports 

GNR 

CMRL 

CMRC 

CMRR 

LDR 

DVRL 

DVRC 

DVRR 


Value 

VIEWP_5 

VIEWP_6 

VIEWP_7 

VIEWP_1 

V1EWP_2 

VIEWP_3 

(CMDR_LTICMDR_CrRICMDR_RT) 

(DVRS_LT1DVRS_CTRDVRS_RT) 

(VIEWP_4) 

(VIEWP_0) 

1 

2 

3 

Value 

0 

1 

2 

3 

4 

5 

6 
7 


Symbol  Value 

VISION_BLOCK_SELF_REPAIR_TIME  10  minutes 


int  declarations  and  initialization: 
catc_mode  =  FALSE 
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WORD  declarations  and  initialization: 
vision_state  =  OTW_DAY 
gunners_state  =  OTW_DAY 
drivers_state  =  OTW_DAY 


day  or  night 
day,  night  or  thermal 
day,  thermal 


2. 2. 6. 4. 3.1  set_gunners_state 

This  routine  sets  the  gunner's  view  state  to  state. 


Parameters 


Parameter 


state 


IEi73 


Where  Tvoedef  Declared 


Standard 


Table  2.2-363:  set_gunners_state  Information. 


2. 2. 6. 4. 3. 2  set_vision_state 
This  routine  sets  the  vision  state  to  state. 


Parameters 


Parameter 


state 


Where  Tynedef  Declared 


Standard 


Table  2.2-364:  set  vision  state  Information. 


2. 2. 6. 4. 3. 3  set_drivers_state 

This  routine  sets  the  driver's  view  state  to  state. 


Parameters 


Parameter 


state 


Where  Tvnedef  Declared 


Standard 


Table  2.2-366:  vision  cmdrs^pitch  Information. 
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2. 2. 6. 4. 3. 5  vision_loaders_pitch 

This  routine  sets  branch  values  and  sets  the  loader's  pitch  state  to  pitch  state. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

pitch  state 

WORD 

mass  stdc.h 

1  Calls  1 

Function 

Where  Described 

set  br  vals 

Section  2.1.2.2.4.7.1 

Table  2.2-367:  vision_loaders_pitch  Information. 


2. 2. 6. 4, 3. 6  vision  cmdrs  binoculars 


This  routine  sets  branch  values  and  sets  the  commanders  binoculars  to  NO_BINOC. 


I  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

bin  state 

WORD 

mass  stdc.h 

I  Calls  I 

Function 

Where  Described 

set  br_  vals 

Section  2.1.2.2.4.7.1 

Table  2.2-368:  vision  cmdrs  binoculars  Information. 


2. 2. 6. 4. 3. 7  vision_restore_all_blocks 

This  routine  sets  view  flags  and  view  modes  to  restore  all  views. 


1  Internal  Variables  I 

Internal  Variable 

Where  Typedef  Declared 

i 

register  int 

Standard 

1  Calls  1 

Function 

Where  Described 

set  view  flaas 

Section  2.1.2.2.4.8.1 

set  vmodes 

Section  2.1.2.2.4.9.1 

Table  2.2-369:  vision  restore  all  blocks  Information. 
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2 . 2 . 6 . 4 . 3 . 8  vision_break_all_bIocks 

This  routine  clears  view  flag  bits,  blackening  all  screens. 


1  Internal  Variables  1 

Internal  Variable 

Where  Tvpedef  Declared 

i 

reaister  int 

Standard 

1  Calls  1 

Function 

Where  Described 

clear. view  flaas 

Section  2.1.2.2.4.2.1 

set  vmodes 

Section  2.1.2.2.4.9.1 

Table  2.2*370:  vision  break  all  blocks  Information. 


2. 2. 6. 4. 3. 9  vision_break_gps 

This  routine  clears  view  flag  bits  for  gunner  view,  blackening  the  gunner’s  primary  sight 
screen. 


1  Calls  1 

Function 

Where  Described 

clear  view  Haas 

Section  2.1.2.2.4.2.1 

set  vmodes 

Section  2.1.2.2.4.9.1 

Table  2.2-371:  vision_break_gps  Information. 


2.2.6.4.3.10  vision_break_driver_blocks 

This  routine  clears  view  flag  bits  for  driver  and  commander  views,  blackening  the  driver’s 
screens. 


1 Cans 1 

Function 

Where  Described 

clear  view  flaqs 

Section  2.1.2.2.4.2.1 

set  vmodes 

Section  2.1.2.2.4.9.1 

Table  2.2-372: 

vislon_break_driver_blocks  Information. 

2.2.6.4.3.11  vision_break_dr  i  ver_center_block 

This  routine  clears  view  flag  bits  for  driver  views,  blackening  the  driver's  center  screen. 

1  Calls  1 

Function 

Where  Described 

clear_view_  flaps 

Section  2. 1.2.2. 4. 2.1 

set  vmodes 

Section  2.1.2.2.4.9.1 

Table  2.2-373:  vision_break_driver_center_bIock  Information. 
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2.2.6.4.3.12  vision  break  cmdrs  blocks 


This  routine  clears  view  flag  bits  for  commander  views,  blackening  the  conunander's 


screens. 

1  Calls  1 

Function 

Where  Described 

clear  view  flaas 

Section  2.1.2.2.4.2.1 

set  vmodes 

Section  2.1.2.2.4.9.1 

Table  2.2-374: 

vision_break_cmdrs_blocks  Information. 

2.2.6.4.3.13  vision_break_ldrs_pscope 

This  routine  clears  view  flag  bits  for  loader  views,  blackening  the  loader's  periscope 

screen. 

1  Calls  1 

Function 

Where  Described 

clear  view  flaqs 

Section  2.1.2.2.4.2.1 

set  vmodes 

Section  2.1.2.2.4.9.1 

Table  2.2-375: 

vision_break_ldrs_pscope  Information. 

2.2.6.4.3.14  vision_restore_gps 


This  routine  sets  view  flags,  restoring  the  gunner’s  primary  sight  screen. 


1  Calls  1 

Function 

Where  Described 

set  view  .flags 

Section  2.1. 2.2.4. 8.1 

set  vmodes 

Section  2.1.2.2.4.9.1 

Table  2.2-376:  vision_restore_gps  Information. 


2.2.6.4.3.15  vision_restore_dri ver_blocks 
This  routine  sets  view  flags,  restoring  the  driver's  screens. 


1  Calls  1 

Function 

Where  Described 

set  view  flags 

Section  2.1.2.2.4.8.1 

set  vmodes 

Section  2. 1.2.2. 4.9.1 

Table  2.2-377:  vision  restore  driver  blocks  Information. 
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2,2.6.4.3.16  vision_restore_cmd rs_blocks 

This  routine  sets  view  flag  bits,  restoring  the  commander's  screens. 


1  Calls  1 

Function 

Where  Described 

set  _view_  flaas 

Section  2.1. 2.2.4. 8.1 

set  vmodes 

Section  2.1.2.2.4.9.1 

Table  2.2>378:  vision  restore  cmdrs  blocks  Information. 


2.2.6.4.3.17  vision_restore_Idrs_pscope 


This  routine  sets  view  flags  for  the  loader's  periscope,  restoring  the  screen. 


1  Calls  1 

Function 

Where  Described 

set  _view_  flaas 

Section  2.1.2.2.4.8.1 

set  vmodes 

Section  2.1.2.2.4.9.1 

Table  2.2-379:  vision_restore_Idrs_pscope  Information. 


2.2.6.4.3.18  vision_get_dvr_rt_vp 

Tbis  routine  returns  the  driver's  right  viewpon  state. 


1  Return  Values  1 

Return  Value 

Tvoe 

Meaninq 

DVRR 

int 

deiver's  riqht  viewport  state. 

Table  2.2-380:  vision_get_dvr_rt_vp  Information. 


2.2.6.4.3.19  vision_get_dvr_ctr_vp 


This  routine  returns  the  driver's  center  viewport  state. 


1  Return  Values  I 

Return  Value 

Meaninq 

DVRC 

int 

driver’s  center  viewport  state 

Table  2.2-381:  vision_get_dvr_ctr_vp  Information. 
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2.2.6.4.3.20  vision_get_dvr_lt_vp 
This  routine  returns  the  driver's  left  viewport  state. 


1  Return  Values  I 

Return  Value 

Meanina 

DVRL 

int 

driver’s  left  viewport  state 

Table  2.2*382:  vision_get_dvr_It_vp  Information. 


2.2.6.4.3.21  vislon_get_gnr_vp 

This  routine  returns  the  gunner's  viewport  state. 


1  Return  Values  I 

Return  Value 

Meanina 

GNR 

int 

aunneris  viewport  state 

Table  2.2-383:  vision_get_gnr_vp  Information. 


2.2.6.4.3.22  vision_set_otw_night_vision 
This  routine  sets  the  OTW  night  vision. 

2.2.6.4.3.23  vision_set_gunner_white_hot_thermal 

This  routine  sets  view  mode  for  gunner  to  white  hot  thermal. 


1  Calls  1 

Function 

Where  Described 

set  vmodes 

Section  2.1.2.2.4.9.1 

Table  2.2-384:  vision_set_gunner_white_hot_thermal  Information. 


2.2.6.4.3.24  vision_set_d ri ver_white_hot_thermal 
This  routine  sets  view  mode  for  driver  to  white  hot  thermal. 


1  Calls  1 

Function 

Where  Described 

set  vmodes 

Section  2.1.2.2.4.9.1 

Table  2.2-385:  vision  set  driver  white  hot  thermal  Information. 
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2.2.6.4.3.25  vision_set_gunner_black_hot_thermal 
This  routine  sets  view  mode  for  gunner  to  black  hot  thermal. 


1  Calls  1 

Function 

Where  Described 

set  vmodes  j 

Section  2.1 .2.2.4.9.1 

Table  2.2-386:  vi«om_set_gunner_black_hot_thermal  Information. 


2.2.6.4.3.26  vision_se#_driver_bIack_hot_thermaI 
This  routine  sets  view  mode  for  driver  to  black  hot  thermal. 


1  Calls  1 

Function 

Where  Described 

set  vmodes 

Section  2.1.2.2.4.9.1 

Table  2.2-387:  vta.ion  set  driver  black  hot  thermal  Information. 


2.2.6.4.3.27  get_catc_Bnode 

This  routine  reboms  the  status  of  CATC  mode. 


1  Return  Values  I 

Return  Value  1  Type 

catc  mode  8  int 

The  CATC  mode  status  1 

Table  2-2-388:  get_catc_mode  Information. 


2.2.6.4.3.28  set_catc_inode 
This  routine  sets  CATC  mode  to  TRUE. 


2.2.6.4.3.29  get_visio»_state 
Tliis  routine  returns  the  vision  state. 


1  Return  Values  I 

Return  Value 

Type 

Meanina 

vision  state 

int 

The  vision  state 

Table  2.2-389;  gct  vision  state  Information. 
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2.2.6.4.3.30  vision_set_gunner_no_thernial 

This  routine  sets  gunner  view  flags  and  view  mode  for  no  thermal. 


1  Calls  1 

Function 

Where  Described 

set  view  Haas 

Section  2.1.2.2.4.8.1 

set  vmodes 

Section  2.1.2.2.4.9.1 

Table  2.2-390:  vislon_set_gunner_no_thermal  Information. 


2.2.6.4.3.31  vision  set  driver  no  thermal 


This  routine  sets  driver  view  flags  and  view  mode  for  no  thermal. 


1  Calls  1 

Function 

Where  Described 

set  view  flaqs 

Section  2.1.2.2.4.8.1 

set  vmodes 

Section  2.1.2.2.4.9.1 

Table  2.2-391:  vision  set  driver  no  thermal  Information. 


2.2.6.4.3.32  toggle_driver_vision_state 

This  routine  toggles  driver  vision  states  between  OTW  day  and  night  or  between  black  and 
white  hot  thermal. 


1  Internal  Variables  I 

Internal  Variable 

Tvoe 

Where  Tvpedef  Declared 

toaale  state 

int 

Standard 

Calls 

Function 

Where  Described 

vision  restore  driver  blocks 

Section  2.2.6.4.3.15 

vision_set_driver_black_hot_t 

hermal 

Section  2.2.6.4.3.26 

vision_set_driver_white_hot_ 

thermal 

Section  2.2.6.4.3.24 

Table  2.2-392:  toggle_driver_vision_state  Information. 
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2.2.6.4.3.33  toggle_gunner_vision_state 

This  routine  toggles  gunner  vision  states  between  OTW  day  and  night  or  between  black  and 
white  hot  therm^. 


1  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

toagle  state 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

vision_set _gunner_no_therm 
al 

Section  2.2.6.4.3.30 

vision_set_gunner_black_hot 

thermal 

Section  2.2.6.4.3.25 

vision_set_gunner_white_hot 

thermal 

Section  2.2.6.4.3.23 

lable  2.2-393:  toggle_gunner_vision_state  Information. 


2.2.6.4.3.34  print_view_modes 

This  routine  displays  the  vision  state,  gunner's  state,  and  driver's  state. 


1  Internal  Variables  1 

Internal  Variable 

Type 

Where  Typedef  Declared 

tmp 

pointer  to  WORD 

mass  stdc.h 

i 

int 

Standard 

Calls 

Function 

Where  Described 

get  vmodes 

Section  2.1.2.2.4.5.1 

Table  2.2-394:  print_view_modes  Information. 


2.2.6.4.3.35  vision_init 

This  routine  initializes  failures  in  the  vision  system. 


Calls  I 

Function 

Where  Described 

I  fail  init  failure 

Section  2.5.4.11.2 

Table  2.2-395:  vision  init  Information. 
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2. 2. 6. 4. 4  ml  thermal.c 


Includes: 

"stdio.h" 

"sim_dfns.h'' 

"sim_types.h" 

"sim_macros.h" 

"mass_stdc.h" 

"dgLstdg.h" 

"sim_cig_if.h" 

"libmsg.h" 

"pro_sim.h" 

"timers_dfn.h" 

"timers.h" 

"ml_vision.h" 

"ml_comm_mx.h" 

"ml_gunn_mx.h" 

''ml_thennal.h" 


Defines: 

Thennal  Flags  Value 

THERMAL_STATE_OFF  0 

THERMAL_STATE_COOLING  1 

THERMAL_STATE_READY  2 

THERMAL_STATE_ON  3 

THERMAL_STATE_WARMING  4 

THERMAL  TIMER_DONE  1 

THERMAL.TIMER.NOT.DONE  0 

THERMAL_3X  0 

THERMAL_10X  1 

THERMAL_WHITE_HOT  0 

THERMAL_BLACK_HOT  1 


THERMAL_CXX)LDOWN_DELAY  200 
THERMAL_WARMUP_DELAY  20 

int  declarations: 

therm_state 

therm_mode_switch 

therm_cool_down_state 

therm_wrnn_up_state 

therm_shutter_closed 

therm_polarity 

thenn_mag 

thennal_cooLdown_timer 

thennal_warm_up_timer 

Procedure  declarations: 

start_timing_cooldown_delay() 

start_timing_warmup_delay() 

tum_on_gunners_thermal_view() 

tum_off_gunners_thermal_view() 

stop_cooldown_timer() 
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stop_warmup_timer() 

thennal_cooldown_tiinie«xjt_check() 

thermal_warmup_tiriieoat_check() 


2. 2. 6. 4. 4.1  thermal_init 

This  routine  initializes  the  diennial  and  thermal  cooldown  states. 


2. 2. 6. 4. 4. 2  thermal  sinaal 


This  routine  simulates  the  thermal  vision  system. 


1  Calls  1 

Function 

Where  Described 

thermaLcooldownjimeout_c 

heck 

Section  2.2.6.4.4.19 

thermaLwarmup_timeout_ch 

eck 

Section  2.2.6.4.4.20 

Table  2.2>3'96:  thermal_simul  Information. 


2. 2. 6. 4. 4. 3  thermaI__mode_on 
This  routine  turns  on  the  therraaiS  mode. 


I  Errors  I 

Error  Name 

Reason  for  Error 

ILLEGAL  THERMAL  STATE 

TTie  variable  therm  state  has  an  unexpected  value. 

Calls 

Function 

Where  Described 

start  timinq  cooldown  delay 

Section  2.2.6.4.4.13 

turn_on_gunners_thermal_vi 

ew 

Section  2.2.6.4.4.15 

Table  2.2-39S:  thermal  mode  on  Information. 


661 


BBN  Systems  and  Technologies 


Vehicles  CSQ 


2. 2. 6. 4. 4. 4  thennal_inode_standby 
This  routine  sets  the  thermal  mode  to  standby. 


1  Errors  I 

Error  Name 

Reason  for  Error 

ILLEGAL  THERMAL  STATE 

The  variable  therm  state  has  an  unexpected  value. 

Calls 

Function 

Where  Described 

start  timina  cooldown  delay 

Section  2.2.6.4.4.13 

turn_off_gunners_thermaLvi 

ew 

Section  2.2.6.4.4.16 

Table  2.2-399:  tbermal_mode_standby  Information. 


2. 2. 6. 4. 4. 5  tbermal_mode_off 

This  routine  turns  off  the  thermal  mode. 


I  Errors  I 

Error  Name 

Reason  for  Error 

ILLEGAL  THERMAL  STATE 

The  variable  therm  state  has  an  unexpected  value. 

Calls 

Function 

Where  Described 

stop  cooldown  timer 

Section  2.2.6.4.4.17 

start  timina  warmup  delay 

Section  2.2.6.4.4.14 

turn_off_gunners_thermaLvi 

ew 

Section  2.2.6.4.4.16 

Table  2.2-400:  thermal  mode  off  Information. 


2. 2. 6. 4. 4. 6  thermal_white_hot 

This  routine  sets  the  gunner's  vision  to  hot  thermal  objects  appearing  white. 


1  Calls  1 

Function 

Where  Described 

vision_set_gunner_white_hot 

thermal 

Section  2.2.6.4.3.23 

Table  2.2-401:  thermal  white  hot  Information. 
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2,.2.6.4.4.7  thermal_black_hot 

'Ehis  routine  sets  the  gunner's  vision  to  hot  thennal  objects  appearing  black. 


1  Calls  1 

Function 

Where  Described 

viffiton_setjgunner_black_hot 

^rmal 

Section  2.2.6.4.3.25 

Table  2.2-402:  thermal  black  hot  Information. 


2..2.6.4.4.8  thermal_3x 

Tliis  routine  sets  the  gunner's  primary  sight  to  3X  magnification. 


1  Calls  1 

1  Function  1 

Where  Described 

Section  2.1.2.2.6.4 

Table  2.2-403:  thermal  3x  Information. 


2. 2. 6. 4. 4. 9  thermal  lOx 


TTfiis  routine  sets  the  gunner's  primaiy  sight  ot  lOX  magnification. 


I  Calls  I 

iFtunction  I 

Where  Described 

Section  2.1.2.2.6.4 

Table  2.2-404:  thermal  lOx  Information. 


Z..2.6.4.4.10  thermal_view_on 

Unis  routine  returns  TRUE  if  the  thermal  state  is  on,  FALSE  otherwise. 


1  Return  Values  I 

Rteturn  Value 

Type 

Meanina 

TRUE 

int 

Themial  state  is  on. 

F/r4.LSE 

int 

Thermal  state  is  off. 

Table  2.2-405:  thermal  view  on  Information. 
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2.2.6.4.4.11  thermal_shutter 

This  routine  switches  to  the  thermal  vision  system. 


1  Errors  I 

Error  Nama 

Reason  for  Error 

ILLEGAL  THERMAL  STATE 

The  variable  therm  state  has  an  unexpected  value. 

Calls 

Function 

Where  Described 

vision  break  ops 

Section  2.2.6.4.3.9 

turn_on_gunners_thermal_vi 

ew 

Section  2.2.6.4.4.15 

Table  2.2-406:  thermal  shutter  Information. 


2.2.6.4.4.12  thermal_clear 

This  routine  clears  the  thermal  view. 


Table  2.2-407:  thermal  clear  Information. 


2.2.6.4.4.13  start_timing_cooldown_deiay 
This  routine  starts  the  cooldown  timer. 


1  Calls  1 

Function 

Where  Described 

timers  aet  timer 

Section  2.6.3.6.1 

Table  2.2-408:  start_timing_cooldown_delay  Information. 


2.2.6.4.4.14  start_timing_wa rmu p_delay 

This  routine  starts  the  warmup  timer. 


1  Errors  I 

Error  Name 

Reason  for  Error 

ILLEGAL  THERMAL  STATE 

The  variable  therm  state  has  an  unexpected  value. 

Calls 

Function 

Where  Described 

turn_off_gunners_thermaLvi 

ew 

Section  2.2.6.4.4.16 

vision  restore  ops 

Section  2.2.6.4.3.14 
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2.2.6.4.4.15  turn_on_gunners_thermal_view 
This  routine  turns  on  the  gunner's  thermal  view. 


1  Errors  1 

Error  Name 

Reason  for  Error 

ILLEGAL  THERMAL 

POLARITY 

The  variable  therm jx>larjty  has  an  unexpected  value. 

ILLEGAL  THERMAL 
MAGNITUDE 

The  variable  therm_mag  has  an  unexpected  value. 

Calls 

Function 

Where  Described 

vision_set_gunner_white_hot 

thermal 

Section  2.2.6.4.3.23 

vision_set_gunner_black_hot 

thermal 

Section  2.2.6.4.3.25 

s  mao  3x 

Section  2. 1.2.2. 6.4 

s  mao  lOx 

Section  2.1. 2.2.6  4 

Table  2.2-409:  turn_on_gunners_thermal_view  Information. 


2.2.6.4.4.16  turn_off_gunners_thermal_view 

This  routine  turns  off  the  gunner's  thermal  view. 


Calls 


Where  Described 


Section  2.2.6  4.3.9 


Section 


Section  2.1 .2.2.6. 4 


Section  2. 1.2. 2.6. 4 


vision_set_gunner_no_therm  Section  2.2.6.4.3.30 
al 


Table  2.2-410:  turn_ofr^gunners_thermaI_view  Information. 


Function 


vision  break  ops 


et  non  thermal  ma 


s  mao  3x 


s  mao  lOx 


2.2.6.4.4.17  stop_cooIdown_timer 

This  routine  stops  the  cooldown  timer. 


Calls 


Function  Where  Described 


timers  free  timer  Section  2.6.3.5.1 


timers  set  null  timer  Section  2.6.3.14.1 


Table  2.2-411:  stop_cooldown_timer  Information. 
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2.2.6.4.4.18  stop_heatup_timer 

This  routine  is  a  null  stub. 

2.2.6.4.4.19  thermal_cooldown_timeout_check 

This  routine  checks  for  the  thermal  cooldown  timer  timing  out. 

S  Calls  1 

Function 

Where  Described 

timers  qet  timeout  edae 

Section  2.6.3.22.1 

controIsJhermaLreadyJight 

on 

Section  2.2.2 

tum_on_gunners_thermaLvi 

ew 

Section  2.2.6.4.4.15 

Table  2.2-412:  thermal  cooldown  timeout  check  Information. 


2.2.6.4.4.20  thermal_warmup_ti meout_check 


This  routine  updates  the  thermal  warmup  timer  and,  if  the  warmup  delay  has  elapsed,  sets 
the  appropriate  thermal  variables. 


1  Calls  1 

Function 

Where  Described 

controls  thermal  ready  light 
off 

Section  2.2.2 

Table  i.2-413:  thermal_warmup_timeout_check  Information. 
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2.2.7  Network  Interactions 

Thc£•^st^uctuIe  of  the  Network  Interactions  CSC  is  shown  below. 


Figure  2.2-S:  Structure  of  the  Ml  Network  Interactions  CSC. 

Onct?  each  frame,  the  simulation  must  send  an  update  packet  on  its  own  status  if  that  has 
changed  significantly  in  the  current  frame.  If  the  vehicle's  appearaiice  has  changed,  or  an 
mpdase  has  not  been  sent  in  the  last  5  seconds,  one  will  be  generated.  If  an  update  is  to  be 
sent,  libapp  calls  routines  in  ml_network.c  to  fill  in  vehicle-specific  fields.  Routines  are 
called  in  ml_tracks.c  to  determine  what  size  dust  cloud,  if  any,  should  be  reponed. 

The  {Status  of  internal  subsystems  are  reported  every  30  seconds  (for  reconstitution  and  data 
collection  purposes).  Routines  for  sending  this  status  are  found  in  ml_network.c. 

The  ^simulation  host  also  sends  equipment  status  packets  every  30  seconds,  reporting 
amWient  temperature,  power  supply  voltages,  and  other  hardware  specific  information.  The 
routkies  for  reporting  on  hardware  status  are  found  in  the  vehicle  specific  files 
ml  network.c. 


The:  following  CSU  provides  this  functionality: 
ml_network.c 
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2. 2. 7.1  nil_network.c 

(/simnet/release/src/vehicle/ml/ml_network.c  [ml_network.c]) 


Includes: 

"stdio.h" 

"sim_types.h" 

"sim.dfns.h" 

"sim_macros.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"pro_data.h" 

"pro_sim.h" 

"pxo_mgmt.h" 

"pro_size.h" 

"status_ml.h" 

"net/network.h" 

"libnetwork.h" 

"libkin.h" 

"libhuU.h" 

"libfaiLh" 

"libturret.h" 

"Ubapp.h" 

"librva.h" 

"ml_status.h" 

"ml_engine.h" 

"ml_ammo.h" 

"ml_elecsys.h" 

"ml.fuelsys.h" 

'’ml_tracks.h’' 


Defines: 

Symbols  Yaiy? 

THRESHOLD_FILE  "/simnet/vehicle/ml/data/mlthresh.d"  if  _GT_  defined 
THRESHOLD_FILE  "/simnet/vehicle/ml/data/ml_thresh.d"  if  _GT_  not  defined 
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2.2.7. 1.1  send_equipinent_status 

This  routine  sends  an  equipment  status  PDU  over  the  network. 


1  Internal  Variables  1 

Internal  Variable 

Type 

Where  Typedef  Declared 

Ddu 

IfaianaaementPDU 

p  data.h 

pkt 

pointer  to  register 
EquipStatusV  ariant 

p_mgmt.h 

i  Calls  1 

Function 

Wliere  Described 

network  qet  simulator  type 

Section  2.1.1.3.1.19.1 

what  is  voltaael2P 

Section  2. 1.5. 2.1 

what  is  voltaQe12N 

Section  2.1. 5.2.2 

what  is  voltaoeS 

Section  2.1. 5.2.3 

what  is  temperature 

Section  2.1. 5.2.4 

is  host  healthy 

Section 

is  ciQ  healthy 

Section 

is  .sound  healthy 

Section 

Section 

1  is  .turret,  healthy 

Section 

UE&iiiiSXikkllimHiHIH 

Section 

networkjill  hdr  send  mgmt 
pkt 

Section  2.1.1.3.1.42.7 

PRO  MGMT  EQUIP  STATU 

S  SIZE 

p_size.h 

Table  2.2*414:  send_equipment_status  Information. 
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2 . 2 .7 . 1 . 2  fin_vehicle_spec_status 

This  routine  fills  an  Ml  vehicle  specific  status  packet. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

pkt 

pointer  to  register 
VehicleStatusVariant 

p_data.h 

1  Calls  1 

Function 

Where  Described 

enaine  aet  max  power 

Section  2.2.6.2.2.14 

electsvs  aet  battery  voltaqe 

Section  2.2.6.3.1.11 

fuel  level  left 

Section  2.2.5.2.16 

fuel  level  riaht 

Section  2.2.5.2.17 

fuel  level  rear 

Section  2.2.5.2.15 

ammo_get_ready_apds_quan 

tity 

Section  2.2.5.1.38 

ammo_get_hull_apds_quantit 

V 

Section  2.2.5.1.36 

ammo jet_ready_heat_quan 
titv 

Section  2.2.5.1.37 

ammo_get_semi_heat_quanti 

tv 

Section  2.2.5.1.33 

ammo_get_hull_heat_quantit 

V 

Section  2.2.5.1.35 

Table  2.2-415:  fin_vehicle_spec_status  Information. 


2 . 2 . 7 . 1 . 3  fiH_vehlcle_spec_appearance 

This  routine  fills  a  vehicle  specific  appearance  packet. 


1  Parameters  1 

Parameter 

Type 

Where  Tvoedef  Declared 

pkt 

pointer  to  register 
VehicleAppearanceVariant 

p_sim.h 

Calls 

Function 

Where  Described 

turret  aet  network  azimuth 

Section  2.5.5.2.15 

turret  aet  network  elevation 

Section  2.5.5.2.14 

Table  2.2-416:  fill_vehicle_spec_appearance  Information. 
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2 . 2 .7 . 1 .4  ■etwork_process_activation__parameters 

This  routine  psocesses  activation  parameters;  sets  failures,  sets  up  tracks,  sets  vehicle 
status,  sets  amiao  stacui^  and  sets  fuel  system. 


\  Parameters  1 

Parameter 

Where  Typedef  Declared 

£ 

pointer  to  VehicieStatus 

status.h 

1  Internal  Variables  I 

Internal  VarMkfe 

Where  Typedef  Declared 

status 

pointer  to 

SIMNET  M1  Status 

stat_ml  .h 

1  Calls  1 

Function 

Where  Described 

fail  set  subsvs 

Section  2.5.4.14.2 

stall  maintenance  corKttsn 

Section  2.5.4.26.2 

tracks_set_iniliiaLdislarK3iB_k 

m 

Section 

ammo  init  amnv  racks 

Section  2.2.5.1.5 

fuel  init  tanks 

Section  2.2.5. 2.1 

Table  2J2417;  aetwork_process_activation_parameters  Information. 


2.2.7. 1,5  app_iii»l 


This  routine  ixieializeslltesholds. 


1  Errors  I 

Error  Name 

Reason  for  Error 

Network:  coutdnl  init 
thresholds 

A  call  to  network_init_thresholds  returned  a  zero. 

Calls 

Function 

Where  Described 

network  init  thresholds 

Section  2.1.1.3.1.66.5 

Thble  2.2-418:  appjnit  Information. 


2. 2. 7. 1.6  veh_sfec_activate_time 

This  routine  retams  60. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

60 

int 

N/A 

Table  7.2-419:  veh  spec  ac‘*vafe  time  Information. 
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2.3  M2  Vehicle  Simulation  Functions 


Figure  2.3-1:  Structure  of  the  M2  Vehicle  Simulation  Software  CSC. 

A  distributed  vehicle  simulation  performs  a  set  of  tasks  each  frame.  It  checks  the  state  of  its 
controls,  updates  lights  and  meters,  checks  its  failure/repair  model,  manages  munitions, 
models  its  hull  (and  turret)  subsystems,  does  kinematics/dynamics,  simulates  weapons,  and 
communicates  with  the  outside  world.  This  cycle  of  tasks  is  referred  to  below  as  the  main 
simulation  loop.  The  second  level  CSCs  that  make  up  this  CSC  are  as  follows: 

Top  Level  M2  Simulation  Software 
M2  Controls  /  Switchology 
M2  Weapons 
M2  Failures 

M2  Munitions  Management 
M2  Vehicle  Model 
M2  Network  Interactions 
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2.3.1  M2  Top  Level  Software 

In  the  SIMNET  vehicle  simulations,  the  main  simulation  loop  is  found  in  libmain.  This  loop, 
executed  one  each  frame,  invokes  generic  functions  to  perform  tasks  common  to  the  Ml  and 
M2  simulations.  It  also  invokes  a  vehicle-specific  routine  which  is  defined  by  the  individual 
simulations  in  m2_main.c.  The  one  CSU  associated  with  this  CSC  is  therefore  m2_main.c. 


Figure  2.3-2:  Structure  of  the  M2  Top  Level  Vehicle  Software  CSC. 
2.3. 1.2  in2_main.c 

(/simne  f/release/src/vehicle/m l/src/m2_main.c  [m2_main.c]) 


This  file  contains  routines  used  in  the  SIMNET  simulation  of  the  M2  Bradley  Fighting  Vehicle. 


Includes: 


"stdio.l^" 

"ctype.h" 

"signal.h" 

"sim_dfns.h" 

"sim_macros.h" 

"sim_types.h" 

"simstdio  b" 

"mass_stdc.h" 

"dgLstdg.h" 

"sim_cig_if.h" 

"pro  assoc.h" 

"pro_sim.h" 

"status.h" 

'status_m2.!i" 

"veh  type.h" 

"mun  type.h" 

"failure.h" 

"fifo.dfn.h" 

"tifo.h" 

"bigwheel.h" 

"libterrain.h" 

"libkin.h” 

"libfail.h" 

"Ubc*6.h" 

"bbd.h" 

"libhull.h" 

"libidc.h" 

"libmain.h" 

"libmem.h" 

"libmsg.h" 

"libnetwork.h" 

’librepair.h” 

"librva.h" 

"libsusp.h" 

"libturret.h" 

"libsound.h" 

"libmap.h" 

"m2_alpha.h" 

"rr.2_ammo.h" 

"m2_bcs.n" 

"m2_(.ig.h" 

"m2_cnirl.h'' 

"tii2  cntrllr.h” 

"m2_cons.b'' 

"m2_cupola.h" 

"m2_dlrain.h' 
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"m2_engine.h" 

"m2_firectl.h" 

"m2_fuelsys.h" 

"m2_handles.h' 

"m2_isu.h" 

"m2_keybrd.h" 

"m2_launcher.h" 

"m2_meter.h" 

"m2_pots.h’’ 

"m2_ptrain.h" 

"ni2_ramp.h" 

"m2  repair.h" 

"m2_resupp.h" 

"m2_slope.h" 

"m2_sound.h" 

"m2_status.h" 

"m2_weapons.h" 

"m2  turret.h" 

"m2  vision.h" 

"timers.h" 

"dtad.h" 

"status. h" 

"ser_status.h" 

The  following  are  declared: 
debug 

print_ovemins 

butterfly_silent_mode 

reboot_on_shutdown 

initial_bbd[] 

exit()  -  if  SIMBFLY  is  not  defined 

The  following  are  declared  for  the  '-p'  switch: 
init_activ 
imtial_activation 

The  following  is  defined: 

PARS.FILE 


2. 3. 1.1.1  silent_mode_on 

This  routine  sets  butterfly  silent  mode  to  TRUE. 

2. 3. 1.1. 2  silent  jmodeoff 

This  routine  sets  butterfly _silent  mode  to  FALSE. 

2. 3. 1.1. 3  print_help 


This  routine  prints  out  data  for  the  M2  simulation. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

proqname 

pointer  to  char 

Standard 

Table  2.3-1:  print^help  Information. 


I 


2. 3. 1.1. 4  printvehlogo 

This  routine  prints  a  logo  for  the  M2  vehicle. 
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2. 3. 1.1. 5  veh_spec_sltartup 

This  routine  sets  up  the  network  and  CIG  interfaces  at  startup. 


1  Calls 

Function 

Where  Described 

network  set  simulator  type 

Section  2.1.1.3.1.53.1 

use  ciQ  reconfiQ  startup 

Section 

ciQ  set  view  confio  file 

Section  2.1.2.2.2.23.1 

aet  vconfiQ  filet 

Section  2.5. 1.2.2 

map  vehicle  file  read 

Section  2.6.11.5.1 

aet  veh  map  file 

Section  2.5. 1.2.5 

map  read  asid  file 

!  Section  2.6.11.4.1 

aet  asid  map  file 

Section  2.5. 1.2.4 

map  file  read 

Section  2.6.11.3.1 

aet  ammo  map  file 

Section  2.5. 1.2.6 

keybrd  init 

Section  2. 1.6.3 

failure  init 

Section  2.3.4.1.1 

map  aet  damaae  files 

Section  2.6.11.1.1 

Tabte  2,3-2:  veh_spec_startup  Information. 


2. 3. 1.1. 6  veh_spec_icaie 


This  routine  is  called  while  thae  simulator  is  in  the  IDLE  state. 


1  Calls  1 

Function 

Where  Described 

status  simul 

Section  2. 1.5.3 

keyboard  simul 

Section  2. 1.6.3 

io  simul  idle 

Section  2.1.2.2.5.1.2 

process  activate  request 

Section  2. 1.1. 3. 2.1.1 

network  qet  exercise  id 

Section  2.1.1.3.1.16.1 

Tabic  2.3-3:  veh_spec_idle  Information. 
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2. 3. 1.1. 7  veh_spec_init 

Order  dependent  initializations  are  performed  for  all  of  the  M2’s  subsystems  while  the 
simulator  is  in  the  SIMINIT  state. 


1  Calls  1 

Function 

Where  Described 

vision  init 

Section  2.3.6.3.2 

cupola  init 

Section  2.3.6.1.2 

sound  init 

Section  2.1 .3.3.4 

alpha  init 

Section  2.3. 2.3.1 

status  preset 

Section  2. 1.5.3 

ammo  init 

Section  2.3.5.1.1 

controls  fsm  init 

Section  2.3.2.2.1 

controls  hnp  init 

Section  2.3.2 

controls  mpc  init 

Section  2.3.2.1.2 

controls  tnp  init 

Section  2.3.2 

controls  tpc  init 

Section  2.3.2.1.3 

bcs  init 

Section  2.3.3.1 

resupply,  init 

Section  2.3.5.3.28 

meter  init 

Section  2.3.2.3.3 

electsysinit 

Section  2.3.6.3.1.40 

firecti  init 

Section  2.3.2.2.3 

isu  init 

Section  2.3.6.3.4 

powertrain  init 

Section  2.3.6  2.1.1 

handles  init 

Section  2.3.2.2.2 

weapons  init 

Section  2.3.3.2 

controls  edge,  init 

Section  2.3.2 

Section  2.3. 7. 1.5 

config  pos  init2 

Section  2.1.2.2.2.24.2 

kinematics  get  o  to  h 

Section  2. 5.8. 2,4 

kinematics  get  w  to  h 

Section  2. 5.8. 2.1 

init  brow  pad  state 

Section  2.1.2.2.7.3 

Table  2.3-4:  veh_spec_init  Information. 


»  _ 
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2. 3. 1.1. 8  veh_spec_simulate 

This  routine  calls  the  routines  which  simulate  the  various  functins  of  the  M2's  subsystems  on  a 
tick  by  tick  basis. 


1  Internal  Variables  | 

Internal  Variable 

Where  Typedef  Declared 

start 

Iona 

Standard 

end 

Iona 

Standard 

Calls 

Function 

Where  Described 

status  simul 

Section  2. 1.5.3 

keyboard  simul 

Section  2.1. 6.3 

sound  simul 

Section  2.1. 3.3.6 

controls  simul 

Section  2.3.2 

handles  simul 

Section  2.3.2.2.2 

ammo  simul 

Section  2.3.5. 1.2 

resupply  simul 

Section  2.3.5.3.29 

electsys  simul 

Section  2.3.6.3.1.8 

firecti  simul 

Section  2.3.2.2.3 

isu  simul 

Section  2.3.6.3.4 

fuel  simul 

Section  2.3.5.2.3 

powertrain  simul 

Section  2.3.6.2.1.2 

bcs  simul 

Section  2.3.3. 1 

weapons  simul 

Section  2.3.3  2 

ramp  simul 

Section  2.3.6. 1.3.2 

launcher  simul 

Section  2.3.6.1.4.2 

slope  simul 

Section  2. 3. 2.3. 6 

cupola  simul 

Section  2.3.6. 1.2 

Table  2.3-5:  veh_spec_simulate  Information. 


2. 3. 1.1. 9  veh_spec_stop 

This  routine  is  called  while  the  simulator  is  in  the  SIMSTOP  state.  The  IDC  and  sound  system 
hardware  are  reinitialized. 


1  Calls  1 

Function 

Where  Described 

idc  init 

Section  2.1.4.1.1.24.1 

sound  init 

Section  2.1. 3.2.4 

vision  break  all  blocks 

Section  2.3.6.3  2 

Table  2.3-6:  veh  spec  stop  Information. 
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2.3.1.1.10 


veh_spec_exit 


This  routine  is  called  while  the  simulator  is  in  the  SIMEXIT  state.  Simulation  statistics  are 
printed  and  the  network  connection  is  closed. 


1  Internal  Variables  I 

Internal  Variable 

Where  Tvpedef  Declared 

num  ticks 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

alpha  reset 

Section  2.3.2.3.1 

keyboard  exit  qracefully 

Section  2.1. 6.3 

timers  aet  current  time 

Section  2.6.3.2.1 

timers  qet  current  tick 

Section  2. 6.3. 1.1 

timers  elapsed  milliseconds 

Section  2.6.3.10.1 

network  print  statistics 

Section  2.1.1.3.2.16.1 

net  close 

Section  2.20.2.3.1  in  MCC  CSCI  SDD 

Table  2.3-7:  veh_spec_exit  Information. 
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2.3.1.1.11  main 

This  routine  loops  through  the  M2  simulation  once  each  frame.  The  generic  simulation 
routines  in  “libmain”  are  called  by  this  routine. 

The  parameters  are  read  and  parsed: 


case -a 

Not  used. 

case  -b 

Bumper  numbers  are  used. 

case  -c 

Keyboard  use  cupola. 

case  -d 

Debugging  is  turned  on. 

case-D 

Debugging  for  static  vehicles  is  enabled. 

case-e 

The  ethemet  is  closed. 

case  -E 

The  exercise  ID  is  set. 

case  -F 

cfail  debug  is  on. 

case  -g 

The  CIG  isn’t  using  graphics. 

case  -h 

Print  help. 

case  -? 

Print  help. 

case  -k 

The  key  ardisused. 

case  -n 

Vebose  mode  is  used. 

case  -o 

Overrun  printing  is  enabled. 

case  -p 

The  simulator  is  started  in  stand  alone  mode.  The  simulator  acts  as  if  it 
has  received  an  activation  packet  from  the  MCC.  This  segment  of  code 
is  similar  to  that  used  by  the  MCC  to  activate  a  simulator. 

case  -P 

Proximity  list  debugging  is  enabled. 

case  -r 

Initial  reticle  values  are  set. 

case  -s 

Sound  is  not  used. 

case  -t 

Use  the  database  override  named. 

case-T 

The  DED  names  are  set. 

case -V 

Terrain  verbose  mode  is  enabled. 

case  -V 

The  voltmeter  is  disabled. 

case  1 

The  CIG  mask  and  device  are  set. 

1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

aroc 

int 

Standard 

aroc 

pointer  to  char 

Standard 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard 

initial  headina 

float 

Standard 

status 

pointer  to 

SIMNET  M2  Status 

status.h 

gp 

pointer  to 

GroundVehicleSubsystems 

status. h 

unit 

pointer  to  OrganizationalUnit 

basic. h 

status  bits 

unsigned  int 

Standard 
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Function 


network  set  exercise  id 


mam  read  oars  Viie 


use  bumper  numbers 


keyboard  use  cupola 


use  static  debu 


network_dont_really_open_u 
p  ethernet 


network  set  exercise  id 


cfail  debuo  on 


cia  not  usina  oraphics 


rint  hel 


keyboard  reaiiy  use 


V  pkt  verbose  mode 


rva  turn  debuo  on 


idc  set  reticle  init  val 


sound  dont  use 


cig_use_database_Override_ 

named 


isalpha 


set  ded  name 


terrain  verbose  mode  on 


electsys  voltmeter  disabled 


set  cio  dev 


set  cig  mask 


Sim  state  startu 


simulation  state  machine 


et  default  db  name 


et  default  db  version 


Calls 


Where  Described 


Section  2.5.1. 1.1 


Section  2.1.3.1.49.1 


Section  2.5. 1.2.1 


Section  2. 1.6.3 


Section 


Section  2.1.1.3.2.14.1 


Section  2.1.1.3.1.49.1 


Section  2.5.4.2.1 


Section  2.1. 2.2.1. 5.1 


Section  2.3.1. 1.3 


Section  2. 1.6.3 


Section  2.1.1.3.1.16.1 


Section  2.5.12.2.1 


Section  2. 1.4. 1.3.5 


Section  2.1. 3.3.5 


Section  2.1.2.2.1.16.1 


Section  2.3.2.3.1 


Section  2.1. 2.2.1. 8.2 


Section  2.5.11.9.1 


Section  2.3.6.3.1.39 


Section  2.1.2.2.1.26.1 


Section  2.1.2.2.2.114.1 


Section  2.5. 1.1. 5 


Section  2.5.1.1.13 


Section  2.5.1.2.15 


Section  2.5.1.2.16 


Table  2.3-8:  main  Information. 


2.3.1.1.12  reconstitute  vehicle 


This  routine  reconstitues  a  vehicle  by  sending  an  activate  request  sent  to  the  MCC. 


1  Calls  1 

Function 

Where  Described 

process  activate__request 

Section  2. 1.1. 3.2.1. 1 

network  get  exercise  id 

Section  2.1.1.3.1.16.1 

Table  2.3-9:  reconstitute  vehicle  Information. 
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2.3.2  M2  Controls/Switchology 

A  large  portion  of  the  code  generated  for  specific  vehicles  exists  in  this  section.  Since 
every  vehicle  has  its  own  complement  of  differing  controls  and  indicators,  these  files  exist 
in  vehicle  specific  code.  This  second  level  CSC  is  further  broken  down  into  the  following 
third  level  CSC’s: 

Low  Level  Control  Handling 
Finite  State  Machines 
Specialized  Output  Devices 


Low  Level 
Control 
Handling 

5.2.3.1 

Finite  State 
Machines 

5.2.3.2 

Specialized 

Output 

Devices 

5.2.3.3 

ni2  ctl  tdc.c 

5.2.3.1.1 

m2  ctl  fsm.c 

5.2.3.2.1 

m2  alpha.c 
- 5.213.3.1 

m2  cll  mpc.c 

5.2.3. 1.2 

m2  handles.c 

5.2.32.2 

m2_gages.c 
-  5.2.3.3.2 

m2_cll  tpc.c 

5.2.3. 1.3 

m2  firectl.c 

5.23.2.3 

m2_met0r.c 

5.2.3.3.3 

m2  ctl  hnp.c 
-  5.2.3. 1.4 

m2  odom.c 
-  5.2.3.3.4 

m2  ctl  tnp.c 
-  5.2^.  1.5 

m2 _pots.c 
5.2-3.3.5 

m2_slope.c 
- 5.2.3.3.6 

Figure  2.3-3:  Structure  of  the  M2  Controls  /  Switchology  CSC. 
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2.3.2. 1  Low  Level  Control  Handling 

Since  the  simulation  is  interested  in  transitions  of  a  control,  the  past  state  of  a  control  must 
be  maintained  and  up^ted  each  tick  of  the  simulation.  Therefore,  a  state  variable  is  defined 
for  each  control  in  a  vehicle  simulation.  The  controls  are  grouped  into  separate  files  based 
on  the  "power  state".  The  "power  state"  of  a  control  is  defined  as  the  power  requirements 
to  make  the  control  active. 

To  increase  efficiency,  the  past  state  of  a  control  is  only  maintained  when  a  control  is 
active.  The  last  three  letters  of  the  files  listed  above  are  the  initials  of  the  power  states: 

mpc:  master  power  controls 
n^:  no  power  controls 
tpc:  turret  power  controls 
mp:  turret  no  power 
hnp:  hull  no  power 
tdc;  turret  drive  controls 

2. 3. 2. 1.1  m2_ctl_tdc.c 

(/simnet/release/src/vehicle/ml/src/m2_ctl_npc.c  [m2_ctLtdc.c]) 

This  CSU  provides  the  turret  drive  controls  interface  for  the  M2  simulator.  This  module 
includes  the  following  files: 


"stdio.h" 

"m2_ctLdf.h" 

"sim_types.h" 

"m2_cntrl.h" 

"sim_dfns.h" 

"m2_driv_pn.h" 

"sim_macros.h" 

"m2_turr_pn.h" 

"timers_dfn.h" 

"ni2_driv_mx.h" 

"timers.h" 

"m2_turr_mx.h" 

"libidc.h" 

"m2_pots.h" 

"libidc_dfn.h" 

"m?  .handles.h" 

"libmem.h" 

"m2,  weapons.h" 

"libmem_dfn.h" 

"m2_turreet.h" 

"libnetwork.h" 

"m2_sound.h" 
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This  file  defines  the  following  parameters  for  use  in  controlling  the  turret  drive 
mechanisms: 


Variables 

real  aunn  trav  val 

REAL 

Sim  tvpes.h 

real  aunn  elev  val 

REAL 

Sim  tvpes.h 

real  comm  trav  val 

REAL 

Sim  tvpes.h 

real  comm  elev  val 

REAL 

Sim  tvpes.h 

hex  aunn  trav  val 

int 

Standard 

hex  aunn  elev  val 

int 

Standard 

hex  comm  trav  val 

int 

Standard 

hex  comm  elev  val 

int 

Standard 

turret  stab  val 

int 

Standard 

aunner  palm  val 

int 

Standard 

aunner  fast  slew  val 

int 

Standard 

aunner  triaaer.val 

int 

Standard 

commander  palm  val 

int 

Standard 

commander  fast  slew  val 

int 

Standard 

commander  triaaer  val 

int 

Standard 

Table  2.3-10:  m2_cU_tdc.c  variables. 

This  file  defines  the  routines  listed  in  the  table  below. 

Initialization  Routines: 

These  routines  initialize  all  starting  values  for  the  gunner  and  commander  controls.  If  these 
controls  are  on,  they  are  initialized  to  either  off  or  zero  depending  on  the  initial  state. 


Name 

Type  of  routine 

controls  tdc  init  () 

void 

controls  aunner  traverse  initO 

void 

controls  aunner  elevation  init  () 

void 

controls  commander  traverse  initO 

void 

controls  commander  elevation  initO 

void 

controls  turret  stab  initO 

void 

controls  ounner  palm  initO 

void 

controls  aunner  fast  slew  initO 

void 

controls  aunner  triaqer  initO 

void 

controls  commander  palm  initO 

void 

controls  commander  fast  .slew  initO 

void 

controls  commander  triaaer  initO 

void 

Table  2.3-11:  Initialization  Routines. 
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Turret  Drive  Routines: 

The  following  routines  control  the  tuiret  drive  controls  by  checking  the  control  state  of  the 
turret  drive  gunner  and  commander  traverse,  elevation,  stability,  slew,  trigger  values,  and 
palm  values.  If  these  values  are  out  of  acceptable  range  as  determined  by  internal  routines 
called  by  these  routines,  an  error  message  will  appear  on  the  appropriate  gunner  or 
commander  terminal  screen. 


Name 

Type  of  routine 

controls  aunner  traverse  checkO 

void 

controls  qunner  elevation  checkO 

void 

controls  commander  traverse  checkO 

void 

controls  commander  elevation  checkO 

void 

controls  turret  stab  checkO 

void 

controls  qunner  palm  check) 

void 

controls  qunner  fast  slew  checkO 

void 

controls  qunner  triqqer  check!) 

void 

controls  commander  palm  check!) 

void 

controls  commander  fast  slew  check!) 

void 

controls  commander,  triqqer  check!) 

void 

Table  2.3-12:  Turret  Drive  Routines. 


Exit  Routines: 

These  routines  examine  the  gunner  and  commander  traverse,  elevation,  stability,  slew,  and 
palm  values,  trigger  values,  values  for  the  gunner  and  commander  controls.  If  these 
controls  are  on,  they  are  set  to  off  or  zero  to  properly  and  gracefully  exit  the  controls 
module. 


Name 

Type  of  routine 

controls  qunner  traverse  exit!) 

void 

controls  qunner  elevation  exit!) 

void 

controls  commander  traverse  exit!) 

void 

controls  commander  elevation  exit!) 

void 

controls  turret  stab  exit!) 

void 

controls  qunner  palm  exit!) 

void 

controls  qunner  fast  slew  exit!) 

void 

controls  qunner  triqqer  exit!) 

void 

controls  commander  palm  exit!) 

void 

controls  commander  fast  slew  exit!) 

void 

controls  commander  triqqer  exit!) 

void 

Table  2.3-13:  Exit  Routines. 
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2.3.2. 1.2  in2_ctl  mpc.c 

(/simnet^lease/src/vehicle/m  l/src/m2_cd_mpc.c  [m2_ctl_mpc.c]) 

This  CSU  provides  the  master  power  controls  interface  for  the  M2  simulator.  This  module 
includes  the  following  files: 


'stdio.h" 

"m2  tmrs  df.h" 

'sim  types.h" 

"m2_cU._df.h" 

’sim_dfns.h" 

"m2_driv_pn.h" 

'sim_macros.h" 

"m2_driv_mx.h' 

'timers_dfn.h" 

"m2_tuiT_pn.h" 

'timers.h" 

"m2  pots.h" 

'libidc.h" 

"m2_cntrl.h" 

'Ubidc_dfn.h" 

"m2_ramp.h" 

'libmem.h" 

"m2_elecsys.h" 

'libmem_dfn.h" 

"m2_fuelsys.h" 

libnetwork.h" 

"m2_engine.h" 

'm2  main.h" 

This  file  also  defines  the  following  parameters  for  use  in  controlling  the  master  power 
mechanisms. 


Variables 

Type 

Where  typedef 
declared 

real  steer  bar  val 

real 

sim  types.h 

real  throttle  val 

REAL 

sim  types.h 

real  accelerator  val 

REAL 

sim  types.h 

hex  steer  bar  val 

int 

Standard 

hex  throttle  val 

int 

Standard 

hex  accelator  val 

int 

Standard 

enqine  accessory  val 

char 

Standard 

tranmission  val 

char 

Standard 

ramp  uo  down  val 

char 

Standard 

driver  panel  test  val 

char 

Standard 

parkinq  brake  status 

char 

Standard 

cool  hi  temp  flash  count 

int 

Standard 

cool  lo  level  flash  count 

int 

Standard 

trans  oil  pres  lo  flash  count 

int 

Standard 

fuel  filt  cloq  flash  count 

int 

Standard 

launcher  up  flash  count 

int 

Standard 

air  clean  cloq  flash  count 

int 

Standard 

enq  oil  pres  lo  flash  count 

int 

Standard 

cool  hi  temp  flash  event  edqe 

int 

Standard 

cool  lo  level  flash  event  edqe 

int 

Standard 

trans  oil  pres  lo  flash  event  edqe 

int 

Standard 

trans  oil  temp  hi  fiash  event  edqe 

int 

Standard 

fuel  filt  cloq  flash  event  edqe 

inf 

Standard 

launcher  up  flash  event  edqe 

int 

Standard 

air  clean  cloq  flash  event  edqe 

int 

Standard 

enq  oil  ores  lo  flash  event  edqe 

int 

Standard 

hull  radio  failure  status 

inf 

Standard 

hull  intercom  failure  status 

int 

Standard 

Table  2.3-14:  m2_ctl_mpc  Variable.s. 
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This  file  defines  the  routines  listed  in  the  tables  below. 


Initialization  Routines: 

These  routines  initialize  all  starting  values  for  the  master  power  controls.  If  these  controls 
arc  on,  they  arc  initialized  to  off  or  zero  depending  on  the  initial  state. 


Name 


controls  steer  bar  init 


controls  throttle  init 


controls  enoine  accesso 


controls  transmission  init 


controls  ramp  up  down  init 


controls  driver  panel  test  init 


Type  of  routine 


void 


void 


void 


void 


void 


void 


Table  2.3-15:  Initialization  Routines. 

Master  Power  Routines: 

These  routines  check  and  evaluate  the  steer  bar,  engine  accessories,  throttle,  ramp  state, 
driver  panel,  cool  hi  and  lo  levels,  tranmission,  fuel  filter,  launcher  state,  air  cleaner 
condition,  and  engine  oil  pressure  and  will  return  alarm  messages  to  indicate  that  there  may 
be  a  power  control  that  needs  adjustment  or  checking. 


Name 


controls  steer  bar  check 


controls  throttle  check 


controls  enqine  accessory  check 


controls  transmission  check 


controls  ramp  up  down  check 


controls  tone  cancel  check 


controls  driver  panel  test  check 


controls  cool  hi  temp  flash  check 


controls  cool  lo  level  flash  check 


controls  trans  oil  ores  lo  flash  check 


controls  trans  oil  temp  hi  flash  check 


controls  fuel  filt  cloq  flash  check 


controls  launcher  up  flash  check 


Type  of  routine 


void 


void 


void 


void 


void 


void 


void 


void 


void 


void 


void 


void 


void 


Table  2.3-16:  Master  Power  Routines. 
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Exit  Routines: 


These  routines  examine  the  steer  bar.throttle,  engine  accessories,  driver  panel  test  module, 
and  ramp  state  controls.  If  these  controls  are  on,  they  are  set  to  off  or  zero  to  properly  exit 
the  power  controls  module. 


Name 

Type  of  routine 

controls  steer  bar  exitO 

void 

controls  throttle  exitO 

void 

controls  enaine  accessory  exitO 

void 

controls  driver  panel  test  exitO 

void 

controls  ramp  up  down  exitO 

void 

Table  2.3-17:  Exit  Routines. 

Miscellaneous  Routines: 

The  controls_driver_panel_test_on()  routine  will  turn  or  set  to  on  the  controls  on  the 
driver  panel  to  specified  starting  values.  If  these  values  are  incorrect  or  have  somehow  been 
changed  to  unacceptable  values,  controls_driver_panel_test_restoreO  will  restore 
known  good  values  to  the  driver  panel  status  display. 


Name 

Type  of  routine 

controls  driver  panel  test  onO 

void 

controls  driver  panel  test  restored 

void 

Table  2.3-18: 


Miscellaneous  Routines. 
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2.3.2. 1.3  in2_ctl  tpc.c 

(/simnet^lease/src/vehicle/ml/src/m2_ctl_tpc.c  [ni2_ctl_tpc.c]) 

This  CSU  provides  a  controls  interface  for  the  M2  simulator. 

This  CSU  provides  the  turret  power  controls  interface  for  the  M2  simulator.  This  module 
uses  these  include  files; 


stdio.h 

m2_ctl_df.h 

"sim_types.h" 

"m2_cntrl.h" 

"sim_dfns.h" 

’’m2_driv_pn.h" 

"sim_macros.h" 

”m2_turr_pn.h" 

"timers_dfn.h" 

"m2_driv_mx.h" 

"timers.h" 

"m2_turr_mx.h" 

"libidc.h" 

"m2  firectl.h" 

"libidc_dfn.h" 

"m2_handles.h" 

"libmem.h" 

"m2_weapons.h" 

"libmem_dfn.h" 

"m2_turret.h" 

"libnetwork.h" 

"m2_sound.h" 

"libfail.h" 

"m2_ammo.h" 

"failure.h" 

"m2_tmrs_df.h" 

"m2_main.h" 

"m2_electsys.h" 

The  file  "m2_ctl_tpc"  defines  the  following  parameters  for  use  in  controlling  the  turret 
power  mechanisms. 


Variables 

Type 

Where  typedef 
declared 

turret  drive  val 

char 

Standard 

commander  panel  tst  val 

char 

Standard 

arm  safe+reset  val 

char 

Standard 

aunner  launcher  val 

char 

Standard 

sear  flashina  status 

char 

Standard 

low  ammo  flashinq  status 

int 

Standard 

missilel  flashing  status 

int 

Standard 

missile2  flashing  status 

int 

Standard 

sear  flash  count 

int 

Standard 

low  ammo  flash  count 

int 

Standard 

misslef  flash  count 

int 

Standard 

missile2  flash  count 

int 

Standard 

sear  flash  event  edge 

int 

Standard 

low  ammo  flash  event  edge 

int 

Standard 

missilel  flash  event  edge 

int 

Standard 

missile2  flash  event  edge 

int 

Standard 

turret  ref  ind  status 

nt 

Standard 

turret  radio  failure  status 

int 

Standard 

turret  intercom  failure  status 

int 

Standard 

gunner  turret  ref  translations 

array  of  int 

Standard 

commander  turret  ref  translations 

array  of  int 

Standard 

Table  2.3-19:  m2_ctl_tpc  Variables. 
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This  file  defines  the  routines  listed  in  the  table  below. 

Initialization  Routines: 

These  routines  initialize  all  starting  values  for  the  gunner  and  commander 
turret  power  controls.  If  these  controls  are  on,  they  are  initialized  to  off 
or  zero  depending  on  the  initial  state. 


Name 

Type  of  routine 

controls  turret  drive  initO 

void 

controls  commander  panel  test  initO 

void 

controls  arm  safe  reset  InitO 

void 

controls  gunner  launch  initO 

void 

Table  2.3-20:  Initialization  Routines. 

Turret  Power  Routines: 

The  following  routines  control  the  turret  power  controls  by  checking  the  control  state  of 
these  turret  power  gunner  tow,  missile  select,  low  ammo  override  values,  various  power 
controls  checks  and  the  commander  panel  test  check.  If  these  values  are  out  of  acceptable 
range  as  determined  by  several  other  internal  routines  called  by  these  routines,  an  error 
message  will  appear  on  the  appropriate  gunner  or  commander  terminal  screen. 


Name 

Type  of  Routine 

controls  turret  drive  checkO 

void 

controls  commander  panel  test  checkO 

void 

controls _ arm  safe  reset  checkO 

void 

controls,  low  ammo  override  checkO 

void 

controls  gunner  launcher  checkO 

void 

controls  misfire  checkO 

void 

controls  gunner  tow  select  checkO 

void 

controls  gunner  tow  test  checkO 

void 

controls  gunner  missilet  checkO 

void 

controls  gunner  missile2  checkO 

void 

controls  _ap  ss  checkO 

void 

controls  he  ss  checkf) 

void 

controls  _ap  lo  checkf) 

void 

controls  he  lo  checkO 

void 

controls_ap  hi  checkO 

void 

controls  he  hi  checkO 

void 

controls  sear  flash  checkO 

void 

controls  low  ammo  flash  checkO 

void 

controls  missilet  flash  checkO 

void 

controls  missile2  flash  checkO 

void 

Table  2.3-21:  Turret  Power  Routines. 
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Exit  Routines: 

These  routines  examine  the  gunner  and  commander  turret  power  controls  for 
the  turret  drive  state,  commander  panel  state,  arming  state,  and  launcher 
state.  If  these  controls  are  on,  they  are  set  to  off  or  zero  to  properly 
exit  the  controls  module. 


Name 

Type  of  routine 

controls  turret  drive  exitO 

void 

controls  commander  panel  test  exitO 

void 

controls  arm  safe  reset  exitO 

void 

controls  aunner  launcher  exitO 

void 

Table  2.3-22:  Exit  Routines. 
Miscellaneous  Routines: 

These  routines  examine  the  commander  panel  test  power  controls  state  and  if 
needed,  restores  the  test  panel  values  to  the  appropriate  state. 


Name 

Type  of  routine 

controls  commander  panel  test  onO 

void 

controls  commander  panel  test  restored 

void 

Table  2.3-23:  Miscellaneous  Routines. 
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2.3.2. 1.4  in2_ctl_hnp.c 

(/sininet/i:elease/src/vehicle/ml/src/m2_ctl_hnp.c  [in2_ctl_hnp.c]) 

This  CSU  provides  the  hull  no  power  controls  interface  for  the  M2  simulator.  This  module 
includes  the  following  files: 

"stdio.h" 

"sim_types.h" 

"sim_(frns.h" 

"sim_macros.h" 

"libidc.h" 

"libidc_dfn.h" 

"libmem.h" 

"libmem_dfn.h" 

"failuie.h" 

"libfaiLh" 

The  file  m2_ctl_hnp  also  defmes  the  following  parameters  for  use  in  controlling  the  hull  no 
power  mechanisms. 


"timers_dfn.h" 

’■m2_ctl_df.h" 

"m2_cntrl.h" 

"m2_tmrs_df.h" 

''m2_driv_pn.h" 

''m2_pots.h" 

"m2_fuelsys.h" 

"m2_idc.h" 

"m2_driv_mx.h" 


Variables 

Type 

Where  typedef 
declared 

parkinq  brake  val 

char 

Standard 

real  service  val 

REAL 

Sim  types. h 

hex  service  brake  val 

int 

Standard 

fuel  val 

char 

Standard 

odometer  timer  number 

int 

Standard 

hull  slope  ind  status 

int 

Standard 

driver  slope  translations 

int 

Standard 

Table  2.3-24:  n2_ctl_hnp  Variables. 

This  file  defines  the  routines  listed  in  the  tables  below. 

Initialization  Routines: 

These  routines  initialize  all  starting  values  for  the  hull  no  power  controls.  If  these  controls 
are  on,  they  are  initialized  to  off  or  zero  or  a  specified  starting  value  depending  on  the  initial 
state. 


Name 

Type  of  routine 

controls  parkinq  brake  initO 

void 

controls  service  brake  initO 

void 

controls  . fuel  initO 

void 

Table  2.3-25:  Initialization  Routines. 
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Hull  No  Power  Routines: 

These  routines  check  and  evaluate  the  the  parking  brake,  service  brake,  odometer,  and  fuel 
level.  They  will  return  alarm  messages  to  indicate  that  there  may  be  a  power  control  that 
needs  adjustment  or  checking. 


Name 

Type  of  routine 

controls  parkina  brake  checkO 

void 

controls  service  brake  checkO 

void 

controls  odometer  checkO 

void 

controls  fuel  checkO 

void 

Table  2.3-26:  Hull  No  Power  Routines. 


Exit  Routines: 

These  routines  examine  the  parking  brake,  service  brake,  and  odometer  value  state.  If  these 
brake  controls  are  off,  they  are  set  to  on  or  zero  to  properly  exit  the  controls  module,  and 
the  odometer  is  properly  reset  to  zero. 


Name 

Type  of  routine 

controls  parkina  brake  exitO 

void 

controls  service  brake  exitO 

void 

controls  odometer  exitO 

void 

controls  parkinq  brake  onO 

extern  void 

controls  parkinq  brake  offO 

extern  void 

Table  2.3-27:  Exit  Routines. 
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2.3.2..1..5  m2_ctl_tnp.c 

(/simnet;^lease/src/vehicle/ml/src/m2_ctl_tnp.c  [m2_ctl_tnp.c]) 

This  CSIT  ^provides  the  turret  no  power  controls  interface  for  the  M2  simulator.  This 
module  use^s  these  include  files; 


sMio.h" 

”m2  ctl  df.h" 

'sitm_types.h" 

’•m2_cntrl.h" 

'sii?n_(tfns.h" 

"m2_driv_pn.h" 

'sim_macros.h" 

"m2_turr_pn.h" 

'm3iass_stdc.h" 

"m2  oms  df.h" 

'tiiKiers_dfn,h" 

"m2  bcs.h" 

'dt5Ed.h" 

"m2_cig.h" 

libfidc.h" 

"m2_pots.h" 

'lil3!idc_dfn.h" 

"m2  dtrain.h" 

libmem.h" 

"m2_isu.h" 

'lih»mem_dfn.h" 

"m2_turr_mx.h' 

'libnetwork.h" 

"m2_status.h" 

'm2_idc.h" 

"m2_vision.h" 

This  file  defines  the  following  parameters  for  use  in  controlUng  the  turret  no  power 
mechanismts. 


Variables 

Type 

Where  typedef 
declared 

real  cupola  val 

REAL 

Sim  tvoes.h 

hex  cupola  val 

int 

Standard 

turret  powejr  val 

char 

Standard 

range  select  val 

long 

Standard 

maq  select  val 

int 

Standard 

gunner  brow  pad  val 

char 

Standard 

commander  brow  pad  val 

char 

Standard 

grid  azimulfn  val 

char 

Standard 

cupola  UP  down  val 

char 

Standard 

ammo  hei  can  hei  val 

char 

Standard 

ammo  apd-j  can  hei  val 

char 

Standard 

receive  fla£.^tiing  .status 

char 

Standard 

send  flashkig  status 

char 

Standard 

internal  fla^shinq  status 

char 

Standard 

hei  ilashim:  status 

char 

Standard 

apds  flashk-ig  status 

char 

Standard 

tow  flashirrig  status 

char 

Standard 

dragon  flashing  status 

char 

Standard 

receive  fla<3h  count 

int 

Standard 

send,  flash  count 

int 

Standard 

internal  flash  count 

int 

Standard 

hei  flash  count 

int 

Standard 

apds  flash  count 

int 

Standard 

tow  flash  count 

int 

Standard 

dragon  flash  count 

int 

Standard 

receive  flash  event  edge 

int 

Standard 

send  flash  event,  edge 

int 

Standard 
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internal  fl;ash  event  edae 

int 

Standard 

hei  flash  event  edqe 

int 

Standard 

aods  flash  event  edqe 

int 

Standard 

tow  flash  event  edqe 

int 

Standard 

draqon  flash  event  edqe 

int 

Standard 

gunner  slope  translations[SLOPE  NUM  SE 
CTORSl 

array  of  int 

Standard 

commander  slope  translations[SLOPE  NUM 
SECTORSl 

array  int 

Standard 

Table  2.3-28:  m2_ctl_tnp  Variables. 

This  file  defines  the  routines  listed  in  the  table  below. 

Initialization  Routines: 

These  routines  initialize  all  starting  values  for  the  gunner  and  commander  brow  pad,  range 
select,  magazine  select,  cupola  up  and  down  initial  values,  and  ammo  controls  inititti 
values.  If  these  controls  are  on,  they  are  initialized  to  off  or  zero  depending  on  the  initial 
state. 


Name 

Type  of  routine 

controls  turret  power  initO 

void 

controls  cupola  initO 

void 

controls  ranqe  select  initO 

void 

controls  maq  select_initO 

void 

controls  ounner  brow  pad  initO 

void 

controls  commander  brow  pad  initO 

void 

controls  cupola  up  down  initO 

void 

controls  controls  ammo  hei  can  initO 

void 

controls  ammo  apds  can  initO 

void 

Table  2.3-29:  Initialization  Routines. 
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Turret  No  Power  Routines: 

The  following  routines  control  the  turret  no  power  controls  by  checking  the  control  state  of 
these  turret  power  vaues  including  the  cupola,  range  select,  magazine  select,  gunner  and 
commander  brow  pad  status,  grid  azimuth  state,  and  ammo  controls  states.  If  these  values 
are  out  of  acceptable  range  as  determined  by  other  internal  routines  called  by  these  routines, 
an  error  message  will  appear  on  the  appropriate  gunner  or  commander  terminal  screen. 


Name 

Type  of  routine 

controls  turret  power  checkO 

void 

controls  cupola  checkO 

void 

controls  ranoe  select  checkO 

void 

controls  mao  select  checkO 

void 

controls  qunner  brow  pad  checkO 

void 

controls  commander  brow  pad  checkO 

void 

controls  arid  azimuth  checkO 

void 

controls  cupola  up  down  checkO 

void 

controls  ammo  receive  checkO 

void 

controls  ammo  send  checkO 

void 

controls  ammo  internal  checkO 

void 

controls  ammo  hei  checkO 

void 

controls  ammo  apds  checkO 

void 

controls  ammo  tow  checkO 

void 

controls  ammo  draqon  checkO 

void 

controls  ammo  hei  can  checkO 

void 

controls  ammo  apds  can  checkO 

void 

controls  receive  flash  checkO 

void 

controls  send  flash  checkO 

void 

controls  internal  flash  checkO 

void 

controls  hei  flash  checkO 

void 

controls  apds  flash  checkO 

void 

control  tow  flash  checkO 

void 

controls  draqon  flash  checkO 

void 

Table  2.3-30;  Turret  No  Power  Routines. 


Exit  Routines: 

These  routines  examine  the  gunner  and  commander  brow  pad  controls  status,  cupola 
status,  turret  power  status,  and  ammo  controls  status.  If  these  controls  are  on,  they  are  set 
to  off  or  zero  to  properly  exit  the  controls  module. 


Name 

Type  of  routine 

controls  turret  power  exitO 

void 

controls  qunner  brow  pad  exitO 

void 

controls  commander  brow  pad  exitO 

void 

controls  cupola  up  down  exitO 

void 

controls  ammo  hei  can  exitO 

void 

controls  ammo  apds  can  exitO 

void 

Table  2.3-31:  Exit  Routines. 
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2. 3. 2. 2  Finite  State  Machines 

In  general,  finite  state  machines  describe  the  appropriate  actions  to  take  when  a  control 
changes  value.  The  following  arc  examples  of  the  type  of  functions  that  arc  contained  in 
the  files  listed  above; 

i)  When  the  driver  of  an  m2  tank  presses  the 
accelerator,  the  simulation  must  first  discern  the 
states  of  the  engine,  transmission,  emergency  brake, 
etc.  before  the  actions'  effect  can  be  determined 

ii)  When  the  gunner  on  an  ml  tank  pulls  the  trigger, 
the  simulation  must  first  check  the  states  of  the 
gunners  palm  grip,  commanders  palm  grip,  the  weapon 
loaded,  etc.  before  determining  the  necessary  actions 
resulting  from  the  trigger  pull. 

The  following  CSU's  perform  these  functions: 

m2_ctl_fsm.c 

m2_handles.c 

m2_firectl.c 


2. 3. 2. 2.1  m2_ctl  fsm.c 

(./simne^release/src/vehicle/m2/src/m2_ctl_fsm.c  [m2_ctl_fsm.c) 


This  CSU  provides  the  finite  power  state  controls  interface  for  the  M2  simulator.  This 
module  includes  the  following  files; 


"stdio.h" 

"sim_types.h" 

"sim_dfns.h" 

"timers.h" 

"libidc.h" 

"libidc_dfn.h" 

"libmem.h" 

"libmem_dfn.h" 

"m2_main.h" 


"m2_ctl_df.h" 

"m2_driv_pn.h" 

"m2_turr_pn.h" 

"m2_pots.h" 

”m2_cntrl.h" 

"m2_bcs.h" 

"m2_isu.h" 

"libnetwork.h" 
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This  file  also  defines  the  following  parameters  for  use  in  controlling  the  finite  power  state 
mechanisms. 


Variables 

Type 

controls  hull  status  on  edae 

int 

standard 

controls  hull  status  off  edae 

int 

Standard 

controls  hull  electsvs  val 

int 

Standard 

controls  hull  electsvs  off  edae 

char 

Standard 

controls  hull  electsvs  on  edae 

char 

Standard 

controls  turret  backup  electsvs  val 

char 

Standard 

controls  turret  backup  electsvs  off  edqe 

char 

Standard 

controls  turret-backup  electsvs  on  edae 

char 

Standard 

controls  failure  val 

int 

Standard 

controls  failure  off  edge 

int 

Standard 

controls  failure  on  edge 

int 

Standard 

controls  turret  drive  val 

int 

Standard 

controls  turret  drive  val 

int 

Standard 

controls  turret  drive  on  edge 

int 

Standard 

controls  turret  driveoff  edge 

int 

Standard 

controls  turret  power  svsteem  val 

int 

Standard 

controls  turret  power  svstem  on  edge 

int 

Standard 

controls  turret  power  svstem  edqe 

int 

Standard 

controls  master  power  val 

char 

Standard 

Table  2.3-32:  m2  ctl  fsm  Variables. 


This  file  defines  the  routines  listed  in  the  tables  below. 

Hull  State  Transition  Routines 

These  routines  check  the  next  state  or  value  for  the  hull  and  master  power  levels.  If  a  no 
power  state  is  detected  then  the  hull  status,  hull  electrical  system  values  are  set  to  specified 
initial  values  which  are  usually  defined  as  an  OFF  state.  They  will  also  test  for  disallowed 
values  and  print  an  error  message  saying  an  impossible  state  has  been  entered,  and  will 
reset  that  state  with  the  routine  controls  fsm  initO. 


Name 

Type  of  routine 

controls  hull  no  power  next  state!) 

void 

controls  master  power  next  state!) 

void 

Table  2.3-33:  Hull  State  Transition  Routines. 
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Turret  State  Transition  Routines 

These  . '  j  es  check  the  next  state  or  value  for  the  turret  electrical  system  and  turret  drive 
power  stat«.  \  a  no  power  state  is  detected  then  the  turret  electrical  system  and  turret  drive 
values  are  set  to  specified  initial  values  which  are  usually  defined  as  an  OFF  state.  They 
will  also  test  for  disallowed  values  and  print  an  error  message  saying  an  impossible  state 
has  been  entered,  and  will  reset  that  state  with  the  routine  controls_fsni_init(). 


Name 

Type  of  routine 

controls  turret  no  power  next  stated 

void 

controls  master  power  next  stated 

void 

controisjurret  drive  next  stated 

void 

controls  lamp  init  d 

void 

Table  2.3-34:  Turret  State  Transition  Routines. 
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2. 3. 2. 2. 2  in2_handles.c 

(./sinanetAeIcase/srcA'ehicle/m2/src/m2_handles.c  [m2_handles.c) 

The  CSU  m2_handl<es.c  con  tains  state  machines  that  keep  track  of  the  gunners  and 
commanders  palm  grips,  and  the  associated  control  of  the  respective  turrets.  This  is  the 
gunner's  and  commander's  controls  module.  Information  is  passed  between  the  controls 
module  and  the  parts  of  the  simulation  that  need  the  information  (turret,  gunnery,  and  laser 
range  finder  systems).  The  file  checks  to  see  whether  the  handles  are  working,  and  which 
set  of  handles  is  engaged. 

Includes: 

"sim_types.r^" 

"sim_dfns.h " 

"sim_macros.h: 

"failure.h" 

"libfaiLh" 

"m2_bcs.h" 

"m2_weapons.h" 

"m2_turret.h." 

"m2_launcher.h" 


Defines: 

Launcher  Constants 
LAUNCHER_UP_V^AL 
LAUNCHER_DOWN_VAL 
LAUNCHER_IDLE_VAL 

Procedure  Declarations: 

handles_launcher_c£»eck() 

handles_launcher_default() 

ini  variable  declarati>ons: 

gunner_contTol_stat5j  s 

cmdr_contro5_status 

gunner_contTol_engaged 

cmdr_contro  i_engaged 
gunner_fast__  trav_pushed 
cmdr_.fast_trav_pushed 
gunner_trigg  er_pushcd 
cmdj_,trigger_pushc  J 
gunner_trigg  er_edgo 
cmdr  trigger_edge 
trigger__is_puiled 
iduncher_control 
old  iauncher_contn;'l 

REAL  variai'  -  deck  rations 


■'.ni”  traV'/rsc 
<  rnoi  I  ravers.. 


Yalus 

0 

1 

2 


-  maintenance  status:  normally  WORKING 

--  booleans  which  tell  whether  palm  switches 
are  engaged 

-  TRUE  or  FALSE 
--  Level  triggered 

-  Either  TRUE  or  FALSE 

-  Level  triggered 


—  Normalized  values  from  -1.0  to  t- 1.0  which 
are  received  directly  from  the  controls  module 
and  passed  to  the  turret  if  the  appropriate 
palm  .switch  is  engaged. 
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gunner_elevate 

cmdr_elevate 


2. 3. 2. 2. 2.1  handles_siinul 

This  routine  simulates  the  commander's  controls  on  a  tick  by  tick  basis.  It  checks  to  see  if 
handles  are  working  and  which  handles  are  engaged. 


1  Calls  1 

Function 

Where  Described 

turrel_bandles  values 

Section  2.3.6.1.1.6 

weapons  triqqer  is  pulled 

Section  2.3.3.2.12 

weapons  triqqer  is  released 

Section  2.3.3.2.8 

handles  launcher  check 

Section  2.3.2.2.2.25 

handles  launcher  default 

Section  2.3.2.2.2.26 

weapons  fire 

Section  2.3.3.2.4 

Table  2.3-35:  handles  simul  Information. 


2 . 3 . 2 . 2 . 2 . 2  handles_gunner_con  trol_fixed 
This  routine  repairs  the  gunner's  control. 

2 . 3 . 2 . 2 . 2 . 3  handles_gunner_control_broken 

This  routine  causes  the  gunner's  control  to  fail. 

2. 3. 2. 2. 2. 4  handles_commander_control_fixed 

This  routine  repairs  the  commander's  control. 

2 .3. 2 . 2 . 2 .5  handles_commander_control_broken 

This  routine  causes  the  gunner's  control  to  fail. 

2. 3. 2. 2. 2. 6  handles_gunner_palm_on 

This  routine  engages  the  gunner's  control. 

2. 3. 2. 2. 2. 7  handles_gunner_palm_off 

This  routine  disengages  the  gunner's  palm  switch.  It  is  called  by  the  controls  module  when 
the  gunner's  palm  switch  is  released,  or  when  turret  power  is  turned  off  while  the  gunner's 
palm  switch  is  engaged. 
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2 . 3. 2 .2 . 2 . 8  handles_commander_paIin_on 
This  routine  engages  the  commander's  control. 


2 . 3 . 2 . 2 . 2 . 9  handles_commander_palin_off 

This  routine  disengages  the  commander's  palm  switch.  It  is  called  by  the  controls  module 
when  the  commander's  palm  switch  is  released,  or  when  turret  power  is  turned  off  while 
the  commander's  palm  switch  is  engaged. 


2.3.2.2.2.10  handles_gunner_fast_sIew_on 

This  routine  sets  gunner  Jastjrav jjushed  equal  to  TRUE.  The  gunner’s  palm  switch  is 
set  to  fast  traverse  speed. 


2.3.2.2.2.11  handles_gunner_fast_sIew_off 

This  routine  sets  gunner  Jast  jrav  jushed  equal  to  FALSE.  The  gunner's  palm  switch  is 
set  to  normal  traverse  speed. 


2.3.2.2.2.12  handles_commander_fast_slew_on 

This  routine  sets  cmdr Jastjrav jjushed  equal  to  TRUE.  The  commander’s  palm  switch  is 
set  to  fast  traverse  speed. 


2.3.2.2.2.13  handles_commander_fast_slew_off 

This  routine  sets  cmdr  Jastjrav jjushed  equal  to  FALSE.  The  commander's  palm  switch 
is  set  to  normal  traverse  speed. 


2.3.2.2.2.14  handles_set_gunner_elevation 

This  routine  sets  the  gunner's  elevation  rate  to  elevation  rate. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

elevation  rate 

register  REAL 

Sim  types. h 

Table  2.3-36:  handles  set  gunner  elevation  Information. 
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2.3.2.2.2.15  handles_set_cominander_elevation 
This  routine  sets  the  commander's  elevation  rate  to  elevation  rate. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

elevation  rate 

register  REAL 

Sim  types. h 

Table  2.3*37:  handles  set  commander  elevation  Information. 


2.3.2.2.2.16  handles_set_gunner_tra verse 

This  routine  sets  the  gunner's  traverse  rate  to  traverse  rate. 


1  Parameters  1 

Parameter 

Where  Tvoedef  Declared 

traverse  rate 

register  REAL 

Sim  types. h 

Table  2.3-38:  handles_set_gunner_traverse  Information. 


2.3.2.2.2.17  handles  set  commander  traverse 


This  routine  the  commander's  traverse  rate  to  traverse  rate. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

traverse  rate 

register  REAL 

Sim  types. h 

Table  2.3-39:  handles  set  commander  traverse  Information. 


2.3.2.2.2.18  handles_gunner_trigger_depressed 

This  routine  sets  gunner_trigger_pushed  and  gunner_trigger_edge  equal  to  TRUE  when  the 
gunner's  trigger  is  depressed. 


2.3.2.2.2.19  handles_commander_trigger_depressed 

This  routine  sets  cmdr_trigger_pushed  and  cmdr_trigger_edge  equal  to  TRUE  when  the 
commander's  trigger  is  depressed. 


2.3.2.2.2.20  handles_gunner_t rigger_released 

This  routine  sets  gunner  jrigger _pushed  equal  to  FALSE  when  the  gunner's  trigger  is 
released. 
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2.3.2.2.2.21  handles_cominander_trigger_released 

This  routine  sets  cmdr  trigger  jjushed  equal  to  FALSE  when  the  commander's  trigger  is 
released. 

2.3.2.2.2.22  handles_launcher_up 

This  routine  raises  the  launcher. 

2.3.2.2.2.23  handles_launcher_down 
This  routine  lowers  the  launcher. 


2.3.2.2.2.24  handles_launcher_idle 

This  routine  sets  launcher_control  equal  to  LAUNCHER_IDLE_VAL. 


2.3.2.2.2.25  handles_launcher_check 

This  routine  is  called  on  a  tick  by  tick  basis  in  order  to  set  the  launcher  position. 


1  Calls  1 

Function 

Where  Described 

launcher  up 

Section  2.3.6.1.4.3 

launcher  down 

Section  2.3.6.1.4.4 

launcher  idle 

Section  2.3.6. 1.4.5 

Table  2.3-40:  handles_launcher_check  Information. 


2.3.2.2.2.26  handles_launcher_default 
This  routine  sets  the  launcher  to  the  idle  mode. 


I  Calls  I 

Function 

Where  Described 

launcher  idle 

Section  2.3. 6.1. 4.5 

Table  2.3-41:  handles  launcher  default  Information. 
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2.3.2.2.2.27  handles_init 

This  routine  initializes  the  handles. 


1  Calls  1 

Function 

Where  Described 

fail  init  failure 

Section  2.5.4.11.2 

Table  2.3-42:  handles  init  Information. 
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2. 3. 2. 2. 3  m2_^rectl.c 

(./simuietytelease/src/vehicle/m2/src/m2_firectl.c  [m2_fircctl.c]) 
The  file  m2_firectl.c  computes  the  states  important  to  firing  weapons. 


Includes; 

"stdio.h" 


"sim_types.h;" 
"sim_dfns.h"' 
"sim_macros  .h" 
"basic.h" 


"m2_turr_m»..h" 

"m2_cd_df.b." 

"m2_cntrl.h" 

"m2_firecd.h" 

"m2_laser.h" 

"m2_ammo_<df.h" 

"m2_ammo.h" 


Defines: 

Symliol 

WEAPON_D'ELAY 

int  variable  declaraticms; 
mag_select_vjal 
arm_safe_reset_val 
weapon_cou)nter 


Yalus. 

5 


2. 3. 2. 2. 3.1  f1r«ectl_init 

This  routine  initializK^s  the  fire  control  system  variables  mag_select_val, 
arm_sqfe_reset_val,  und  weapon_comter. 


2. 3. 2. 2. 3. 2  fir<iectl_simul 

This  routine  provider  s  the  tick  by  tick  simulation  of  the  fire  control  system.  The  weapon 
counter  is  decrememred. 


2. 3, 2. 2. 3. 3  fir<ectl_gps_inag_4x 

This  routine  sets  the-  gunner's  primary  sight  magnification  to  4X. 


2. 3. 2. 2. 3. 4  fir^ctl_gps_niag_12x 

This  routine  sets  the  gunner’s  primary  sight  magnification  to  12X. 
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2. 3. 2. 2. 3. 5 


firectl_gps_inag_status 


This  routine  returns  the  magnification  of  the  gunner's  primary  sight. 


1  Return  Values  1 

Return  Value 

Meanina 

mag_select_val 

int 

The  gps  magnification 
selection 

Table  2.3-43:  firectl_gps_inag_status  Information. 


2. 3. 2. 2. 3. 6  firectl_arm 

This  routine  sets  the  fire  control  system  state  to  armed. 


1  Calls  1 

Function 

Where  Described 

controls  firecti  arm  on 

Section  2.3.2 

Table  2.3-44:  firecti  arm  Information. 


2. 3. 2. 2. 3. 7  firecti  safe 


This  routine  sets  the  fire  control  system  state  to  safe. 


1  Calls  1 

Function 

Where  Described 

controls  firecti  arm  off 

Section  2.3.2 

Table 

2.3-45:  firectl_safe  Information. 

2. 3. 2. 2. 3. 8  fi  rectia  rm_safe_reset_sta  tus 

This  routine  returns  the  status  of  the  fire  control  system. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

arm  safe  reset  val 

int 

The  fire  control  system  status 

Table  2.3-46:  firectl_arm_safe_reset_status  Information. 


2. 3. 2. 2. 3. 9  firectl_weapon_removed 

This  routine  sets  weapon_counter  equal  to  WEAPON_DELAY. 
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2.3.2.2.3.10  firectl_weapon_ready 

This  routine  returns  TRUE  if  the  weapon  is  ready  to  fire  (the  weapon  counter  equals  zero), 
and  FALSE  otherwise. 


1  Return  Values  I 

Return  Value 

Meanina 

weapon_counter  ==  0 

int 

If  TRUE,  the  weapon  counter 
is  equal  to  zero; 

If  FALSE,  the  weapon  counter 
is  not  eaual  to  zero. 

Table  2.3-47:  firectI_weapon_ready  Information. 


2.3.2.2.3.11  fi  rectl_25mm_r  eady_to_fire 

This  routine  determines  if  the  25mm  weapon  is  ready  to  fire. 


1  Return  Values  1 

Return  Value 

Meaning 

(controls  turret  power  status 
0  1=  CONTROLS  STATE 
TURRET_NO_POWER) 

&& 

(controls_turret_drive_system 
_status()  ==  ON) 

&& 

(arm  safe  reset  val==TC 
ARM_VAL) 

&& 

(!electsys_drive_malfunction_ 

statusO) 

&& 

(!electsys_25mm_gun_ 
malfunction  statusO) 

int 

If  TRUE,  the  weapon  is  ready 
to  fire; 

If  FALSE,  the  weapon  is  not 
ready  to  fire. 

1  Calls  1 

Function 

Where  Described 

controls  turret  power  status 

Section  2.3.2 

CO  ntrols_tu  rret_d  rive_sy  st  em 
status 

Section  2.3.2 

electsys_drive_malfunction_s 

tatus 

Section  2.3.6.3.1.12 

electsys_25mm_gun_malfunc 
tion  status 

Section  2.3.6.3.1.14 

Table  2.3-48:  firectl_25mm_ready_to_fire  Information. 
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2.3.2.2.3.12  firectl_tow_ready_to_fire 


This  routine  determines  if  the  tow  missile  is  ready  to  fire.  If  the  following  conditions  are 
met,  the  tow  missile  is  ready  to  fire: 

1.  Turret  power  is  on. 

2.  The  turret  drive  system  is  on. 

3.  The  gunner's  primary  sight  magnification  is  12X 

4.  The  tow  missile  is  armed. 

5.  There  is  no  electrical  system  malfunction. 


1  Return  Values  1 

Return  Value 

Type 

Meanina 

(controls  turret jx)wer  status 
0  !=  CONTROLS  STATE 
TURRET  NO  POWER) 

&& 

(controls_turret_drive_system 
statusO  ==  ON) 

&& 

(arm  safe  reset  val==TC 
ARM  VAL) 

&& 

(!electsys_drive_malfunction_ 

statusO) 

&& 

(!electsys_tow_circuit_open_ 

statusO) 

&& 

(mag  select  val  = 

GN  12X  VAL) 

int 

If  TRUE,  the  tow  missile  is 
ready  to  fire; 

If  FALSE,  the  tow  missile  is  not 
ready  to  fire. 

I  Calls  I 

Function 

Where  Described 

controls  turret  power  status 

Section  2.3.2 

controls_turret_drive_system 

status 

Section  2.3.2 

e  lectsys_d  ri  ve_malf  u  net  ion_s 
tatus 

Section  2.3.6.3.1.12 

electsys_tow_circuit_open_st 

atus 

Section  2.3.6.3.1.16 

Table  2.3-49:  rirectl_tow_ready_to_fire  Information. 
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2. 3. 2. 3  Specialized  Output  Devices 

As  stated  in  sectiii>n  2.1,  the  output  devices  for  a  simulation  are  often  vehicle  specific. 
Values  are  comptsted  which  need  to  be  displayed  to  the  operator,  and  new  values  are  sent  to 
the  low  level  couErol  routines  (see  2.1.4).  This  is  accomplished  with  the  following  CSU's: 

m2_alphax: 

ni2 _gages.c 

m2_meter.c 

m2_odona.c 

m2_pots.c 

m2_slope..c 


2. 3. 2. 3.1  niJ_alpha.c 

(./simnet/Eelease/src/vehicle/m2/src/m2_alpha.c  [m2_alpha.c]) 

This  CSU  models  output  devices  on  the  M2.  This  is  the  source  file  for  alpha_numeric 
display. 

Includes: 

"stdio.h" 

"sim_dfna!.h" 

"sim_types.h" 

"sim_macros.h" 

"fifo.dftL-h" 

Tifo.h" 

"m2_alpfca.h" 

"m2_men:p._dfn.h" 

"m2_alpbta_df.h" 

"m2_cti_df.h" 


Defines: 

dig_to_as*,';ii 

char  declarations: 
alphajchatit 

mils_strir!ig  [MILS_STRING_SIZE] 
load_strirag  [L0AD_STRING_S1ZEJ 

uit  variable  declarations; 
load 

oldjoad 

mils 

old_mils 

Procedure  declarauons: 

alpha  seffid  milsO 
alphasend  joad() 
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2. 3. 2. 3. 1.1  alpha_init 

This  routine  initializes  the  alpha-numeric  displays. 


1  Calls  1 

Function 

Where  Described 

fifo  init 

Section  2.6.8.3.1 

alpha  reset 

Section  2.3.2.3.1.2 

Table  2.3-50:  alpha^init  Information. 


2. 3. 2. 3. 1.2  alpha_reset 

This  routine  resets  the  alpha-numeric  display. 


1  Calls  1 

Function 

Where  Described 

fifo.enqueue 

Section  2. 6.8. 2.1 

Table  2.3-51:  alpha_reset  Information. 


2. 3. 2. 3. 1.3  alpha_send_mils 

Given  radians,  this  routine  sends  mils  to  the  alpha-numeric  display. 


I  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

radians 

REAL 

Sim  types. h 

I  Internal  Variables  I 

Internal  Variable 

Where  Typedef  Declared 

units 

int 

Standard 

tens 

int 

Standard 

hundreds 

int 

Standard 

thousands 

int 

Standard 

remainder 

int 

Standard 

I  Calls  I 

Function 

Where  Described 

diq  to  ascii 

Section  2.3. 2.3.1 

fifo  enqueue 

Section  2.6.8.2.1 

Table  2.3-52:  alpha_send_mils  Information. 
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2. 3. 2. 3. 1.4  alpha_send_load 

Given  radians,  this  routine  sends  the  load  to  the  alpha-numeric  display. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

radians 

REAL 

sim  types. h 

1  Internal  Variables  I 

Internal  Variable 

Type 

Where  Typedef  Declared 

degrees 

REAL 

sim  types. h 

shift  degrees 

REAL 

Sim  types. h 

1  Calls  1 

Function 

Where  Described 

rad  to  deg 

Sim  macros.h 

fifo  engueue 

Section  2. 6.8. 2.1 

Table  2.3-53:  alpha_send_load  Information. 


2. 3. 2. 3. 1.5  alpha_send 

Given  radians,  this  routine  sends  mils  and  load  to  the  alpha-numeric  display. 


1  Parameters  j 

Parameter 

Where  Typedef  Declared 

radians 

REAL 

sim  types. h 

1  Calls  1 

Function 

Where  Described 

alpha  send  mils 

Section  2.3. 2.3. 1.3 

alpha  send  load 

Section  2. 3. 2.3. 1.4 

Table  2.3-54:  alpha_send  Information. 


2. 3. 2. 3. 1.6  alpha_get_load 
This  routine  returns  load. 


1  Return  Values  I 

Return  Value 

Meaning 

load 

int 

The  load 

Tabic  2.3-55:  alpha  gcl  load  Information. 
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2. 3. 2. 3. 2  in2_gages.c 

(./simnet/release/src/vehicle/m2/src/m2_gages.c  [m2_gages.c]) 


This  CSU  models  gauges  on  the  M2. 

Includes: 

"stdio.h" 

"math.h" 

"sim_types.h" 

"sim_dfns.h" 

"sim_macros.h” 

"m2_cons.h" 

"m2_gages.h" 

Defines: 

Symbol 

Value 

IDLE  SPEED 

820 

MAX  SPEED 

2700 

SCALE  INTERCEPT 

0.436 

OIL  CUBIC 

-.00000044755 

OIL  QUAD 

.00052867 

OIL  LIN 

-.231049 

OIL  CONST 

38.888 

TORQUE  TEMP  FACTOR 

.0000004 

BLOCK  TEMP  FACTOR 

.00001 

RADIATOR  TEMP  FACTOR 

.00001 

TORQUE  TEMP  CONST 

2500 

int  variable  declarations  and  initialization: 
counter  =  0 


REAL  declarations; 
scale 
oiLpress 
oil_temp 
coolant_temp 
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2. 3. 2. 3. 2.1  gage_oiI_pressure 
This  routine  calculates  the  oil  pressure. 


Parameter 


speed 


o  tern 


IEi73 


e 


REAL 


REAL 


Parameters 


Where  Typedef  Declared 


Sim  types. h 


Sim  types. h 


Return  Value 


oil  press 


Return  Values 


e 


REAL 


Meanin 


the  oil  pressure 


Function 


abs 


Calls 


Where  Described 


Sim  macros. h  &  abs.h 


Table  2.3-56:  gage_oil_pressure  Information. 


2. 3. 2. 3. 2. 2  gage_oil_temperature 

This  routine  calculates  the  oil  temperature. 


Parameter 


old  tern 


cool  tern 


speed 


torque 


Return  Value 


oil  tern 


iBn 


e 


REAL 


REAL 


REAL 


REAL 


Parameters 


Where  Typedef  Declared 


Sim  types. h 


Sim  types. h 


Sim  types. h 


sim  types. h 


e 


REAL 


Return  Values 


Meanin 


the  oil  temperature 


Table  2.3-57:  gage_oil_temperature  Information. 
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2 . 3 . 2 . 3 . 2 . 3  gage_coolant_temperature 
This  routine  calculates  the  coolant  temperature. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

old  temp 

REAL 

Sim  types. h 

0  temp 

REAL 

Sim  types. h 

speed 

REAL 

Sim  types. h 

fail  factor 

REAL 

Sim  types. h 

Return  Values 

Return  Value 

Type 

Meanina 

coolant  temp 

REAL 

The  coolant  temperature 

Table  2.3-58:  gage_coolant_temperature  Information. 
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2. 3. 2. 3. 3  m2_meter.c 

(./simnet/release/src/vehicle/m2/src/m2_meter.c  [ni2_meter.c]) 
Meters  on  the  M2  are  modelled  by  this  CSU. 


Includes: 

"sim_types.h" 

"sim_dfns.h" 

"in2_mtr_df.h" 

’•m2_ctl_df.h" 

"m2_fuel_df.h" 

"m2_driv_pn.h" 

"m2_meter.h" 

"m2_cntrl.h" 

char  declarations: 

speed_set_val 

fuel_set_val 

volt_set_val 

temp_set_val 

press_set_val 

REAL  variable  declarations  and  initialization: 

bottom_fuel_full  =  BOTTOM_FUEL_FULL 


2. 3. 2. 3. 3.1  meter_init 

This  routine  initializes  the  analog  meter  outputs,  speedometer,  fuel  guage,  voltmeter, 
temperature  guage,  and  pressure  guage. 
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2. 3. 2. 3. 3. 2  meter_speed_set 

This  routine  sets  the  reading  on  the  speedometer  to  \al,  the  input  value. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

val 

REAL 

Sim  types.h 

1  Internal  Variables  1 

Internal  Variable 

Type 

Where  Typedef  Declared 

tempt 

char 

Standard 

temp2 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

controls  hull  power  status 

Section  2.3.2 

controls  failure  status 

Section  2.3.2 

idc  output  set 

Section  2.3.2 

Table  2.3-59:  meter_speed_set  Information. 


2. 3. 2. 3. 3. 3  meter  fuel  set 


This  routine  sets  the  value  on  the  fuel  guage  based  on  the  value  of  va/. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

val 

REAL 

Sim  types.h 

1  Internal  Variables  I 

Internal  Variable 

Type 

Where  Typedef  Declared 

tempi 

char 

Standard 

temp2 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

controls  failure  status 

Section  2.3.2 

idc  output  set 

Section  2.3.2 

Table  2.3-60:  meter  fuel  set  Information. 
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2. 3. 2. 3. 3. 4  meter_volt_set 

This  routine  sets  the  reading  on  the  voltmeter  based  on  the  value  of  val. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

vai 

REAL 

Sim  tvpes.h 

1  Internal  Variables  I 

Internal  Variable 

Where  Typedef  Declared 

tempt 

char 

Standard 

temp2 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

controls  hull  power  status 

Section  2.3.2 

controls  lailure  status 

Section  2.3.2 

idc  output  set 

Section  2.3.2 

Table  2.3-61:  meter  volt  set  Information. 


2. 3. 2. 3. 3. 5  meter_temp_set 

This  routine  sets  the  reading  on  the  driver's  temperature  guage  based  on  the  value  of  val. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

val 

REAL 

Sim.  types. h 

1  Internal  Variables  I 

Internal  Variable 

Type 

Where  Typedef  Declared 

tempi 

char 

Standard 

temp2 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

controls  hull  power  status 

Section  2.3.2 

controls  failure  status 

Section  2.3.2 

idc  output  set 

Section  2.3.2 

Table  2.3-62;  meter_temp_set  Information. 
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2. 3. 2. 3. 3. 6  meter_press_set 

This  routine  sets  the  reading  on  the  driver's  oil  pressure  guage  based  on  the  value  of  val. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

val 

REAL 

Sim  types. h 

Internal  Variables 

Internal  Variable 

Type 

Where  Tvpedef  Declared 

press 1 

char 

Standard 

press2 

int 

Standard 

Calls 

Function 

Where  Described 

controls  hull  power  status 

Section  2.3.2 

controls  failure  status 

Section  2.3.2 

idc  output  set 

Section  2.3.2 

Table  2.3-63: 


meter_press_set  Information. 
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2. 3. 2. 3. 4  m2  odom.c 

(./simnetA‘eiease/src/vehicle/m2/src/m2_odom.c  [m2_odom.c]) 

Odometers  on  the  M2  are  modelled  by  this  CSU. 

Includes: 

"stdio.h" 

"sim_types.h" 

"sim_macros.h" 

"sim_dfns.h" 

"m2_cons.h" 

"m2_dtrain.h" 

"libfaiLh" 

REAL  variable  declarations: 
elapsed_km 
elapsed_miles 

int  variable  declarations: 
elapsed_km_int 
km_recorded 
elapsed_miles_int 
miles_recorded 
mile_counter 
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2. 3. 2. 3. 4.1 


odometer  init 


This  routine  initializes  the  odometer  by  setting  all  values  to  zero. 


2. 3. 2. 3. 4. 2  odometer_simul 

This  routine  does  a  tick-by-tick  simulation  of  the  odometer.  It  uses  drivetrain  speed  to 
update  speed,  elapsed  miles,  and  elapsed  km. 


1  Internal  Variables  1 

Internal  Variable 

Type 

Where  Tvpedef  Declared 

speed 

REAL 

Sim  tvpes.h 

Calls 

Function 

Where  Described 

drivetrain  aet  vehicle  speed 

Section  2.3.6.2.4.8 

abs 

Sim  macros.h  &  abs.h 

controls  odometer  pulse 

Section  2.3.2 

sfail  event  occurred 

Section  2.5.4.21.1 

Table  2.3-64:  odometer_siinul  Information. 


2. 3. 2. 3. 4. 3  odom  set  initial  distance  km 


This  routine  sets  the  the  initial  elapsed  km  to  distance. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

distance 

REAL 

Sim  tvpes.h 

Table  2.3-65:  odom  set  initial  distance  km  Information. 


2. 3. 2. 3. 4. 4  vehicle_get_elapsed_km 
This  routine  returns  elapsed  kilometers. 


1  Return  Values  I 

Return  Value 

Meanina 

elapsed  km 

REAL 

The  elapsed  kilometers 

Table  2.3-66:  vehicle_get_e!apsed_km  Information. 
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2 . 3 . 2 . 3 . 4 . 5  odometer_^et_ela  psed_km 
This  routine  returns  elapsed  kaJon^ters. 


1  Return  Values  1 

Return  Value 

Meaning 

elapsed  km 

REAL 

The  elapsed  kilometers 

Table  2.3-67r  odometer_get_elapsed_kiii  Information. 


2 . 3 . 2 . 3 . 4 . 6  odometer_get_elapsed_miles 
This  routine  returns  elapsed  miles. 


1  Return  Values  I 

Return  Value 

Meaning 

elapsed  miles 

i  REAL 

The  elapsed  miles 

Table  2.3-68: 

odometer_get_elapsed_miles  Information. 

2 . 3 . 2 . 3 . 4 . 7  odometer_'mile_coun  ter_reset 

This  routine  sets  the  mile  comnter  equal  to  the  miles  recorded. 

2. 3. 2. 3. 3. 8  odometer  jmile_counter 

This  routine  returns  the  trip  mileage. 

1  Internal  Variables  1 

internal  Variable 

Where  Tvpedef  Declared 

mile  difference 

j  int 

Standard 

1  Return  Values  1 

Return  Value 

Meaning 

mile  difference 

i  int 

the  trip  mileaqe 

Table  2.3-65^:  odometer  mile  counter  Information. 
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2. 3. 2. 3. 5  m2  pots.c 

(./sininet/reIease/src/vehicle/m2/src/m2_pots.c  [m2_pots.c] ) 

Potentiometers  on  the  M2  are  modelled  by  this  CSU. 

This  file  contains  the  procedures  relating  to  the  potentiometers,  which  translate  hex 
potentiometer  values  between  00  and  FF  into  real  numbers  and  call  the  appropriate  M2 
subsystems  with  those  real  values. 

Includes: 

"stdio.h" 

"simstdio.h" 

"sim_types.h" 

"sim_dfns.h" 

"sim_macros.h" 

"libidc_dfn.h" 

"libnetwork.h" 

"m2_pots_df.h" 

"m2_cali_df.h" 

"libpots.h" 

The  following  variables  represent  the  calibrated  hex  values  corresponding  to  the  pot 
extremes,  i.e.,  cm_tur_trav_l  is  the  hex  value  of  the  commanders  turret  traverse  handle 
when  it  is  at  the  full  left  position.  These  values  are  used  to  convert  hex  pot  values  to  real 
numbers. 

The  commander's  turret  traverse:  left,  right,  centered: 
tc_tur_trav_l 
tc_tur_trav_r 
tc_tur_trav_c 

The  commander's  turret  elevate:  depress,  raise,  centered: 
tc_tur_elev_d 
tc_tur_elev_r 
tc_tur_elev_c 

The  gunner's  turret  traverse:  left,  right,  centered: 
gn_tur_trav_l 
gn_tur_trav_r 
gn_tur_trav_c 

The  gunner's  turret  elevate:  depress,  raise,  centered: 
gn_tur_elev_d 
gn_tur_elev_r 
gn_tur_elev_c 

The  driver's  steering  bar:  left,  right,  centered: 
dr_steer_l 
dr_steer_r 
dr_steer_c 
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The  driver's  throttle:  zero,  full: 
dr_throttle_z 
dr_throttle_f 

The  driver's  service  brake:  zero,  full: 
dr_s_brake_z 
dr_s_brake_f 

The  driver's  accelerator:  zero,  full: 
dr_accelerator_z 
dr_accelerator_f 


2. 3. 2. 3. 5.1  pots_init 

This  routine  initializes  the  potentiometers. 


1  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

pots 

pointer  to  FILE 

pots  error 

int 

Standard 

line 

int 

Standard 

tmp  strr401 

char 

Standard 

1  Errors  I 

Error  Name 

Reason  for  Error 

POTS:  can’t  open  calibrate  file 

A  call  to  FOPEN  returned  NULL. 

POTS:  can't  continue 
because  of  calibration  error 

pots_error  ==  TRUE 

POTS:  can't  close  calibrate  file 

A  call  to  FCLOSE  returned  EOF. 

1  Calls  1 

Function 

Where  Described 

nprintf 

Section  2.1.1.3.1.34.1 

pots  check  two 

Section  2. 1.4.1 .2.6.1 

pots  check  three 

Section  2. 1.4.1. 2.5.1 

Table  2.3-70:  pots_init  Information. 
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2. 3. 2. 3. 5. 2  pots_comm_trav_real 

Given  the  potentiometer  value  pot,  this  routine  returns  a  scaled  real  value  between  -1.0  and 
+1.0  for  the  commander's  turret  traverse  control. 


1  Parameters 

Parameter 

Where  Tvpedef  Declared 

pot 

int 

Standard 

1  Return  Values 

Return  Value 

Meanina 

pots_scale_lcr(...) 

REAL 

The  scaled  value  of  the 
commander's  turret  traverse 
control. 

1  Calls  1 

Function 

Where  Described 

pots  scale  Icr 

Section  2. 1.4.1 .2.2.1 

Table  2.3-71:  pots_comm_trav_reaI  Information. 


2. 3. 2. 3. 5. 3  pots_comm_elev_real 

Given  the  potentiometer  value  pot,  this  routine  returns  a  scaled  real  value  between  -1.0  and 
+1.0  for  the  commander's  turret  elevation  control. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

pot 

int 

Standard 

1  Return  Values  1 

Return  Value 

Meanina 

pots_scale_lcr(...) 

REAL 

The  scaled  value  of  the 
commander's  elevation  control 

1  Calls  1 

Function 

Where  Described 

pots  scale  Icr 

Section  2. 1.4.1. 2.2.1 

Table  2.3-72:  pots_comm_eIev_real  Information. 
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2. 3. 2. 3. 5. 4  pots_cupola_reaI 

Given  the  potentiometer  value  pot,  this  routine  returns  a  scaled  real  value  between  -1.0  and 
+1.0  for  the  cupola  control. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

pot 

int 

Standard 

Return  Values 

Return  Value 

Meanina 

pots_scaleJr_both(. . .) 

REAL 

The  scaled  value  of  the  cupola 
control 

1  Calls  1 

Function 

Where  Described 

pots__scale_  Ir  both 

Section  2. 1.4.1. 2.3.1 

Table  2.3-73:  pots_cupoIa_real  Information. 


2. 3. 2. 3. 5. 5  pots_gunn_trav_reaI 

Given  the  potentiometer  value  pot,  this  routine  returns  a  scaled  real  value  between  -1.0  and 
+1.0  for  the  gunner's  turret  traverse  control. 


i  Parameters  1 

■  Parameter 

Where  Typedef  De^'lared 

o 

Q 

int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

pots_scale_lcr(...) 

REAL 

The  scaled  value  of  the 
gunner’s  turret  traverse 
control 

1  Calls  1 

Function 

Where  Described 

pots  scale  Icr 

Section  2. 1.4.1. 2.2.1 

Table  2.3-74:  pots_gunn_trav_real  Information. 
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2. 3. 2. 3. 5. 6  pots_gunn_eIev_reaI 

Given  the  potentiometer  value  pot,  this  routine  returns  a  scaled  real  value  between  -1.0  and 
-Hl.O  for  the  gunner's  turret  elevation  control. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

pot 

int 

Standard 

Return  Values 

Return  Value 

Type 

Meanina 

pots_scaleJcr(...) 

REAL 

The  scaled  value  of  the 
qunner's  elevation  control 

Calls 

Function 

Where  Described 

pots  scale  Icr 

Section  2. 1.4.1. 2.2.1 

Table  2.3-75:  pots_gunn_elev_real  Information. 


2. 3. 2. 3. 5. 7  pots_steer_bar_real 

Given  the  potentiometer  value  pot,  this  routine  returns  a  scaled  real  value  between  -1.0  and 
-f-1.0  for  the  driver's  steering  bar. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

pot 

int 

Standard 

1  Return  Values  I 

Return  Value 

Type 

Meanino 

pots_scaleJcr(...) 

REAL 

The  scaled  value  of  the 
driver's  steerina  bar 

1  Calls  1 

Function 

Where  Described 

pots  scale  Icr 

Section  2. 1.4. 1.2. 2.1 

Table  2.3-76:  pots_steer_bar_real  Information. 
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2. $.2. 3. 5. 8  pots_throttle_real 

Given  the  potentiometer  value  pot,  this  routine  returns  a  scaled  real  value  between  -1.0  and 
+1.®  for  the  driver's  throttle. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

Dot 

int 

Standard 

Return  Values 

Retu^rn  Value 

Type 

Meanina 

pots_scaleJr j30s(...) 

REAL 

The  scaled  value  of  the 
driver's  throttle 

Calls 

Function 

Where  Described 

pots  scale  Ir  pos 

Section  2. 1.4.1. 2.4.1 

Table  2.3-77:  pots_throttle_real  Information. 


2.3. 2. 3. 5. 9  pots_service_brake_reaI 

Givesn  the  potentiometer  value  pot,  this  routine  returns  a  scaled  real  value  between  -1.0  and 
+1.(^J  for  the  driver's  service  brake. 


I  Parameters  I 

Parameter 

Where  Typedef  Declared 

pot 

int 

Standard 

Return  Values 

ReUurn  Value 

Type 

Meaning 

pots._scaleJr j3os(...) 

REAL 

The  scaled  value  of  the 
driver’s  service  brake. 

Calls 

FuhfCtlon 

Where  Described 

pots  scale  Ir  pos 

Section  2. 1.4. 1.2. 4.1 

Table  2.3-78:  pots_service_brake_real  Information. 
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2.3.2.3.5.10  pots_accelerator_real 

Given  the  potentiometer  value  pot,  this  routine  returns  a  scaled  real  value  between  -1.0  and 
-Hl.O  for  the  driver's  accelerator. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

pot 

int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meanina 

pots_scaleJrj3os(...) 

REAL 

The  scaled  value  of  the 
driver's  accelerator 

1  Calls  1 

Function 

Where  Described 

pots  scale  Ir  pos 

Section  2. 1.4.1 .2.4.1 

Table  2.3-79:  pots_accelerator_reaI  Information. 
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2. 3. 2. 3. 6  in2_slope.c 

(./simnetAeIease/src/vehicle/m2/src/m2_slope.c  [ni2_slope.c]) 

This  CSU  models  output  devices  on  the  M2. 

Includes: 

"stdio.h" 

'•math.h" 

"sim_types.h" 

"sim_dfns.h" 

"sim_macros.h" 

"libtumet.h" 

"libmatrix.h" 

"bigwheel.h" 

"iibkin.h" 

"Ubhull.h" 

"timers.h" 

"timers_dfn.h" 

"m2_turret.h" 

"m2_cntrl.h" 


Defines: 

Symbol 

SLOPE_CENTERED_DEGREES 

COS_SLOPE_CENTERED 


Value 

(10.0) 

(0.98480775301) 


REAL  declarations: 

cos_hull_slope 


2. 3. 2. 3. 6.1  slope_simul 

This  routine  determines  what  the  slope  bubble  for  the  hull  and  turret  should  be,  and  passes 
the  information  to  the  controls  module. 


i  Internal  Variables  1 

Internal  Variable 

Type 

Where  Typedef  Declared 

hull  dir 

REAL 

sim  types. h 

turret  dir 

REAL 

Sim  types. h 

slope  centered 

BOOLEAN 

sim  types. h 

Calls 

Function 

Where  Described 

kinematics  qet  slope  ind 

Section  2.5.8. 1.8 

turret  qet  ref  ind 

Section  2.5.5.2.16 

controls  hull  slope  ind 

Section  2.3.2 

controls  turret  slope  ind 

Section  2.3.2 

Table  2.3-80:  slope  simul  Information. 
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2. 3. 2. 3. 6. 2  slope_get_cos_hull_slope 
This  routine  returns  the  cosine  of  the  slope  bubble. 


1  Return  Values  1 

Return  Value 

Meanina 

cos_hull_slope 

REAL 

The  cosine  of  the  hull  slope 
bubble 

Table  2.3-81;  slope_get_cos_huII_slope  Information. 
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2.3.3  M2  Weapons 

The  M2  fires  unguided,  or  ballistic,  rounds  as  well  as  TOW  missiles.  The  simulation  must 
model  the  processes  associated  with  the  weapons  systems  which  take  place  within  the  vehicle. 
It  also  must  model  the  flyout  of  the  round  or  missile  and  the  reaction  to  impacts. 


Figure  2.3-4:  Structure  of  the  M2  Weapons  CSC. 


The  M2  accounts  for  the  ballistic  trajectory  of  the  rounds  fired  in  ballistic  computer  systems. 
These  systems  take  range  to  target  and  turret  traverse  rate  information  coupled  with  knowledge 
about  the  round  to  be  fired  and  calculate  superelevation  and  lead  angles. 

Calculation  of  the  superelevation  and  lead  angles  takes  place  in  m2_bcs.c.  The  range  used  in 
the  M2  is  manually  set  by  the  user.  This  system  is  modeled  in  m2_bcs.c.  This  routine  tells  the 
CIG  the  current  range  so  the  range  can  be  displayed. 

Knowledge  of  the  round  to  be  fired  is  also  maintained  in  m2_bcs.c.  The  required 
superelevation  and  time  of  flight  for  a  particular  round  at  a  particular  range  is  found  using 
routines  in  libball.  This  information  is  used  to  calculate  lead  angle. 

Commands  to  fire  a  ballistic  round  are  initiated  in  the  controls  code.  There  are  a  number  of 
steps  to  be  performed  when  a  round  is  fired  and  these  tasks  are  performed  m2_weapons.c.  The 
availability  of  the  round  is  checked  by  polling  the  munitions  management  code.  If  a  round  is 
available,  the  direction  of  the  gun  tube  is  determined.  This  is  a  combination  of  the  gunner's 
line  of  sight,  the  superelevation  and  lead  angle  determined  in  the  ballistics  computer  and  a 
random  offset  to  model  dispersion.  The  dispersion  is  found  using  routines  in  the  math  library. 
Libball  is  called  to  actually  fire  the  round.  If  the  round  is  successfully  fired,  the  sound  of  firing 
is  made,  the  ammunition  is  decremented  and  a  message  is  put  onto  the  net 

Certain  vehicle  specific  functions  associated  with  firing  ballistic  rounds  are  perfonned  through 
m2_weapons.c.  The  gun  on  the  M2  fires  repetitively  and  the  task  of  tracking  the  rates  of  fire 
and  firing  the  rounds  is  also  performed  in  m2,  weapons.c. 
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The  M2  fires  a  TOW  missile.  Firing  the  missile  is  similar  to  firing  a  ballistic  round.  The 
controls  code  calls  m2_weapons.c  when  the  trigger  is  pulled.  The  weapons  code  times  the 
duration  of  the  trigger  pull  and  checks  a  number  of  conditions.  Items  of  concern  are  vehicle 
speed,  TOW  launcher  up,  and  missile  selected.  If  all  the  necessary  conditions  are  met  for  the 
requii^  amount  of  time  and  a  missile  is  available,  an  attempt  to  fire  a  missile  is  made.  The 
attempt  is  made  by  calling  a  routine  in  libmissile.  If  the  attempt  is  successful,  libmissile  puts  a 
message  on  the  network  and  m2_weapons.c  generates  the  appropriate  sound. 


The  flyout  of  the  TOW  is  modeled  in  libmissile.  M2_weapons.c  sends  missile  control  signals 
to  libmissile.  Libmissile  uses  this  information  along  with  an  understanding  the  the  missile 
characteristics  to  generate  a  series  of  missile  trajectory  chords.  This  chord  information  is  sent 
to  the  CIO  and  to  the  network.  The  CIG  code  determines  when  an  impact  occurs  and  calls 
libmissile.  Libmissile  uses  the  same  routines  used  for  ballistic  rounds  to  generate  the  necessary 
effects  and  place  messages  on  the  network. 

The  following  two  CSU's  contain  the  M2  specific  routines  necessary  for  this  simulation. 


m2_bcs.c 

m2_weapons.c 
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2.3.3. 1  m2_bcs.c 

(./simnet/release/src/vehicle/m2/src/m2_bcs.c  [m2_bcs.c]) 

The  M2’s  ballistic  weapons  are  modelled  by  this  CSU. 

Includes: 

"stdio.h" 

"math.h" 

"sim_types.h" 

"sim_(tfns.h" 

"sim_macros.h" 

"mun_type.h" 

"timers.h" 

"timers_dfn.h" 

"libmatrix.h" 

"libbalLh" 

'’m2_bcs.h" 

"m2_cntrl.h" 

"m2_turret.h" 

Defines: 

Symbol  Value 

BCS_DEBUG  FALSE 

MAX_BCS_SETTING  3000.0 
MIN_BCS_SETTING  0.0 
BCS_BC)OTUP_TIME  1.2  seconds 

BCS_BOOTUP_TICKS  ((int)(BCS_BOOTUP_TIME*TICKS_PER_SECOND)) 
ISU_DELTA_ELEV  (deg_to_rad(0.2)) 

int  declarations  and  initialization: 

bcs_bootup_timer  =  NULL_TIMER 
bcs_booted_up  =  FALSE 
ammo_type_indexed 

bcs_null_status  =  FALSE 

REAL  declarations: 
apds_yb[10] 
apds_zb[10] 
heat _yb[10] 
heat_zb[10] 

bcs_range  in  meters 

super_elevation  sin(super  elevation) 

flight_time  seconds 

char  declarations: 

bcs_range_strf51 

Pointer  to  chai'  declarations  and  initialization: 
bcs.  range_fonTiat  =  "%04d" 


either  TRUE  or  FALSE 
can  be  munition_US_M791, 
munition_USM792,  or  empty 
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Procedure  declarations: 

bcs_set_ballistics_computer() 

tunet_set_super_elevation() 


2.3.3. 1.1  bcs_init 

This  routine  does  a  one-time  initialization  of  the  ballistics  computer  system. 


1  Calls  1 

Function 

Where  Described 

ballistics  load  parameter  file 

Section  2.5.2.3.3 

bcs.set  ballistics  computer 

Section  2.3.3. 1.7 

bcs  ammo  index  no  round 

Section  2.3.3.1.5 

turret  set  super  eievation 

Section  2.3.2.3.6.1.1.31 

Table  2.3-82:  bcs_init  Information. 


2.3.3. 1.2  bcs_simul 

This  routine  performs  the  ballistics  computer  system  simulation  on  a  tick  by  tick  basis. 


1  Calls  1 

Function 

Where  Described 

timers  qet  in  use  status 

Section  2.6.3.7.1 

timers  oet  tickino  status 

Section  2.6.3.20.1 

timers  free  timer 

Section  2.6.3.5.1 

timers  set  nuil  timer 

Section  2.6.3.14.1 

controls_turretj30wer_syste 
m  on 

Section  2.3.2 

turret  set  super  elevation 

Section  2.3.6.1.1.31 

Table  2.3-83;  bcs  simul  Information. 


2. 3. 3. 1.3  bcs_ammo_index_hei_25 

This  routine  notifies  the  ballistics  computer  system  that  the  25mm  gun  is  selected  with  hei 
ammunition. 


1  Calls  1 

Function 

Where  Described 

bcs  set  ballistics  computer 

Section  2.3.3. 1.7 

Table  2.3-84:  bcs  ammo  index  hei  25  Information. 
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2.3.3. 1.4  9cs_amino_index_apds_25 

This  roudne  mcifies  the  ballistics  computer  system  that  the  2Smm  gun  is  selected  with  apds 
ammunitiOB. 


1  Calls  1 

Function 

Where  Described 

bcs  set  baluatits  computer 

Section  2.3.3. 1.7 

Sible  2.3-85:  bcs_ammo_lndex_apds_25  Information. 


2 . 3 . 3 . 1 . 5  &cs_ammo_in  dex_n  o_roun  d 

This  routine  moifies  the  ballistics  computer  system  that  the  25mm  gun  is  no  longer  selected. 
This  routine  iisjalled  when  the  TOW  is  selected,  or  when  no  ammo  is  selected.  The  ballistics 
computer  is  inaiset  from  this  routine;  the  range  string  displayed  in  the  ISU  is  cleared. 


2. 3. 3. 1.6  bcs_range_is 

This  routine  fessalled  by  the  controls  module  to  notify  the  ballistics  computer  system  of  a  new 
range  value.  Tie  bcs  performs  error  checking  on  the  value. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

range  from sw«fch 

REAL 

sim  types. h 

Errors 

Error  Name 

Reason  for  Error 

PANIC--inva?kt  ange ...  in  bcs 

The  variable  range  from  switch  has  an  unexpected  value. 

Calls 

Function  I 

Where  Described 

bcs  set  ba)li.‘3:n3.  computer 

Section  2.3.3. 1.7 

Table  2.3-86;  bcs_range_is  Information. 
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2 . 3 . 3 . 1 . 7  bcs_set_banistics_computer 

This  routine  performs  simulation  of  the  on-board  ballistics  computer.  It  calculates  the  flight 
time  and  super  elevation  of  the  indexed  ammunition  type,  given  the  bcs_range. 


1  Errors  I 

Error  Name 

Reason  for  Error 

BCS  ERROR:  Unknown  ammo 

tyee 

The  variable  ammojypejndexed  has  an  unexpected  value. 

Calls 

Function 

Where  Described 

ballistics  calc  time 

Section  2.5.2.1.1 

ballistics  calc  se 

Section  2.5. 2.1. 2 

turret  set  super  elevation 

Section  2.3.6.1.1.31 

Table  2.3-87:  bcs_set_baIlistics_computer  Information. 


2 . 3 . 3 . 1 . 8  bcs_get_super_elevation 

This  routine  returns  the  super  elevation. 


Return  Values 


Return  Value 

Meaning 

super,  elevation 

REAL 

The  super  elevation 

Table  2.3-88:  bcs_get_super_eIevation  Information. 


2. 3. 3. 1.9  bcs_get_range 

This  routine  returns  the  bcs  range. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

bcs  range 

REAL 

The  bcs  range 

Table  2.3-89:  bcs_get_range  Information. 


2.3.3.1.10  bcs_^get_time_of_flight 

This  routine  returns  the  flight  time  of  the  projectile. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

flight  time 

REAL 

The  flight  time  of  the  projectile 

Table  2.3-90:  bcs_get_time_of_flight  Information. 
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2.3.3.1.11  bcs_get_ammo_ty  pe_indexed 
This  routine  returns  the  type  of  ammunition  selected. 


1  Return  Values  1 

Return  Value 

Meanina 

ammo  type  selected 

int 

The  selected  ammunition  type 

Table  2.3-91;  bcs_get_ammo_type_indexed  Information. 


2.3.3.1.12  bcs_get_range_str 

This  routine  is  called  by  the  graphics  interface  to  get  the  range  to  be  displayed  on  the  screen  of 
the  gunner's  view  (100s  of  meters). 


1  Return  Values  I 

Return  Value 

Meanina 

bcs  ranqe  str 

pointer  to  char 

The  bcs  ranqe  strinq 

Table  2.3-82:  bcs_get_range_str  Information. 


2.3.3.1.13  bcs_turn_computer_on 

This  routine  is  called  by  controls  to  boot  the  ballistics  computer  system  when  turret  power  is 
turned  on. 


1  Calls  1 

Function 

Where  Described 

timers  qet  timer 

Section  2.6.3.6.1 

Table  2.3-93:  bcs_turn_computer_on  Information. 


2.3.3.1.14  bcs_turn_computer_off 

This  routine  turns  off  the  ballistics  computer  system.  This  routine  is  called  when  turret  power 
is  turned  off. 


1  Calls  1 

Function 

Where  Described 

controls_turret_power_syste 
m  off 

Section  2.3.2 

turret.set  super  elevation 

Section  2.3.6.1.1.31 

timers  set  null  timer 

Section  2.6.3.14.1 

timers,  free  timer 

Section  2. 6. 3.5.1 

Table  2.3-94:  bcs_turn_computcr_off  Information. 


BBN  Systems  and  Technologies 


Vehicles  CSQ 


2.3.3.1.15  bcs_str_null 

If  bcs_null_status  is  TRUE,  this  routine  sets  it  FALSE  and  returns  TRUE.  If  bcs_null_status 
is  FALSE,  this  routine  returns  FALSE. 


1  Return  Values  1 

Return  Value 

Meanina 

TRUE 

int 

bcs_null_status  was  TRUE,  is 
now  FALSE. 

FALSE 

int 

bcs_null_status  was  FALSE, 
is  not  chanaed. 

Table  2.3-95:  bcs  str  null  Information. 


2. 3. 3. 2  in2_weapons.c 

(./sirhnet/release/src/vehicle/m2/src/m2_weapons.c  [m2_weapons.c]) 

Miscellaneous  weapons  functions  for  the  M2  are  performed  by  this  CSU. 

Includes: 

"stdio.h" 

"sim_types.h" 

"sim_dfns.h" 

"sim_macros.h" 

"basic.h" 

"mass_stdc.h" 

"dgLstdg.h" 

"sim_cig_if.h" 

"failure.h" 

"libfail.h" 

"librva.h" 

"libevent.h" 

"libmatrix.h" 

"libmath.h" 

"libturret.h" 

"libhull.h" 

"libimps.h" 

"libkin.h" 

"libsound.h" 

"librepair.h" 

"libnetworkh" 

"libball.h" 

"libmissile.h" 

"libmap.h" 

"miss_tow.h" 

"mun_type.h" 

"m2_mem_dfn.h" 

"m2_ammo.h" 

"m2_ammo_df.h" 

"m2_bcs.h" 
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"m2_dtrain.h" 

''m2_elecsys.h" 

"m2_firectl.h" 

"m2_turret.h" 

"m2_sound_dfn  .h " 

"m2_sound.h" 

"m2_weapons.h" 


Defines: 

Symbol 

WEAPONS_EMPTY 
RAD_STD_DEV 
TOW_LAUNCH_X 
TOW_LAUNCH_Y 
TOW_LAUNCH_Z 
TOW_TIMER_DELAY 
GUN_BREECH_X 
GUN_BREECH_Y 
GUN_BREECH_Z 
GUN_LENGTH 
GUN_SIGHT_X 
GUN_SIGHT_Y 
GUN_SIGHT_Z 
EFFECT_OFFSET 
LOW_FIRE_RATE  CHANGE.MASK 

high_fire_ratC.change_mask 

MAX_MISSILES 

TOW_MISSILE  declarations: 

missiles[MAX_MISSlLES] 


Value 

-1 

(mil  to  rad(0.3)) 

Description 

0.3  mils 

(-0.9) 

meters  to  side  of  turret  center 

0.5 

meters  from  center  of  turret 

1.2 

meters  above  gun  axes 

22 

1.5  second  tow  delay 

0.15228 

meters  from  base  of  hull 

(-0.53299) 

meters  from  base  of  hull 

2.275 

meters  from  base  of  hull 

2.83299 

meters  from  turret  center 

0.0 

meters  from  turret  center 

0.96447 

meters  from  turret  center 

0.0 

meters  from  turret  center 

3.0 

9 

lOOrounds  per  minute 

5 

180rounds  per  minute 

2 

missiles  in  flight 

location  of  launch  point  in  turret  coordinates 
location  of  turret  center  in  hull  coordinates 
location  of  sight  in  turret  coordinates 


ammo_type_loaded 
ammo_type_in_flight 
tow_timer  =  0 

tow_launcher_status  =  WORKING 
high_fire_rate  =  FALSE 
multi_shot_mode  =  FALSE 
trigger_is_pulled  =  FALSE 
shot_misfired  =  FALSE 


VECTOR  declarations  and  ’nitialization: 
missile_fire_pos 
turret_center 
rel_sight_pos 

int  declarations  and  initialization: 


Objectlype  declarations; 

ammo,,  type_selecte(l 
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2. 3. 3. 2.1  weapons_missne_is_launched 

This  routine  launches  the  missiles  (up  to  the  maximum  number  of  missiles). 


1  Internal  Variables  I 

Internal  Variable 

Where  Typedef  Declared 

i 

int 

Standard 

launch  point 

VECTOR 

Sim  types. h 

1  Calls  1 

Function 

Where  Described 

vec  mat  mul 

Section  2.6.2.56.1 

vec  add 

Section  2.6.2.57.1 

kinematics  aet  h  to  w 

Section  2.5.8. 1.2 

kinematics  aet  o  to  h 

Section  2. 5.8. 1.4 

missile  tow  fire 

Section  2.5.3.13.2 

ammo  weapon  is  fired 

Section  2.3.5.1.56 

sound  make  const  sound 

Section  2. 1.3. 1.2 

suspension  qun.  fired 

Section  2.5. 6. 1.1 

turret  to  hull  cos 

turret  to  hull  sin 

Table  2.3-96:  weapons_niissile_isJaunched  Information. 


2. 3. 3. 2. 2  tow_fired_check 

This  routine  is  called  each  tick  to  see  if  launcher  conditions  are  met.  If  so,  then  missiles  are 
launched. 


1  Calls  1 

Function 

Where  Described 

firecti  tow  ready  to  fire 

Section  2.3.2.2.3.12 

map_get_network_type_from 
ammo  entry 

Section  2.6.11.2.3 

electsys  tow  request 

Section  2.3.6.3.1.21 

weapons  missile  is  launche 
d 

Section  2. 3.3. 2.1 

Table  2.3-97:  tow  fired  check  Information. 
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2. 3. 3. 2. 3  weapons_fire_round 

This  routine  fires  a  round  of  the  specified  ammo.  First,  fire  position  in  world  coordinates  is 
computed.  The  gun  velocity  vector  is  computed.  Random  biases  are  computed  and  a  biased 
gun-to-world  matrix  is  recorded.  The  gun  is  fired,  notifying  both  suspension  and  ballistics. 
The  routine  calculates  the  gun  muzzle  position,  painting  the  muzzle  blast.  The  network  is 
notified  of  the  weapon  firing. 


Parameter 


ammo 


IE273 


Parameters 


Where  Tvpedef  Declared 


Standard 


Internal  Variable 


un  Dosition 


G 
G 


bias  vector 


un  to  world 


f  DOS 


round  id 


un  muzzle 


1  Qun  muzzlelS 


Internal  Variables 


e 


VECTOR 


VECTOR 


VECTOR 


T  MATRIX 


float 


float 


int 


VECTOR 


float 


Where  Typedef  Declared 


sim  types. h 


Sim  types. h 


sim  types. h 


Sim  types.h 


Standard 


Standard 


Standard 


sim  types.h 


Standard 


Function 


yec  mat  mu  I 


kinematics  aet  h  to  w 


yec  add 


kinematics  aet  o  to  h 


vec  scale 


kinematics  aet  d  pos 


d2f  yec  CO 


bivariant  normal  distribution 


turret  aet  aun  to  world 


eyent  aet  eyentid 


suspension  aun  fired 


turret  to  hull  cos 


turret  to  hull  sin 


ballistics  fire  a  round 


map_get_tracer_from_ammo_ 
entr 


vec  init 


network  send  shell  fire  pkt 


turret  aet  turret  slew  rate 


bcs_get_ammo_typeJndexe 

d 


Where 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Calls 


Described 


2.6.2.56.1 


2.5.8. 1.2 


2.6.2.57.1 


2.5.8.1.4 


2.6.2.64.1 


2.5.8. 1.7 


2.6.2.2.1 


2.6. 1.1.1 


2.3.6.1.1.28 


2.6.9. 1.2 


2.5.6.1.1 


Section  2. 5.2.2. 1 


Section  2.6.11.2.9 


Section  2.6.2.61.1 


Section  2.1.1.3.1.57.1 


Section  2. 3. 6. 1.1. 4 


Section  2.2.3.1.18 


Table  2.3-98:  weapons  fire  round  Information. 


744 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


2. 3. 3. 2. 4  weapons_fire 

This  routine  fires  the  weapon.  It  first  gets  the  ammo  type,  then  determines  the  rate  of  fire 
change  mask.  It  checks  for  the  trigger  being  pulled  in  single-shot  or  multi-shot  mode.  It  fires 
the  weapon  for  the  appropriate  ammo.  It  makes  the  sound  of  firing,  and  keeps  track  of  failures 
and  repairs. 


1  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

fire  rate  chanae  mask 

int 

Standard 

nunnery  frame  counter 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

ammo_round_selected_statu 

s 

Section  2.3.5.1.26 

map_get_ammo_entry_from_ 
network  type 

Section  2.6.11.2.1 

ammo  round  loaded  status 

Section  2.3.5.1.27 

firecti  25mm  ready  to  fire 

Section  2.3.2.2.3.11 

ammo  bolt  position  status 

Section  2.3.5.1.53 

ammoJow_ammo_ready_to_f 

ire 

Section  2.3.5.1.51 

electsys  25mm  oun  request 

Section  2.3.6.3.1.24 

fail  break  system 

Section  2.5.4.8.1 

sound  make  const  sound 

Section  2. 1.3.1. 2 

sfail  event  occurred 

Section  2.5.4.21.1 

ammo  weapon  is  fired 

Section  2.3.5.1.56 

sound  of  main  qun  firino 

Section  2.1. 3.3.9 

weapons  fire  round 

Section  2,3.3.2.3 

firecti  tow  ready  to  fire 

Section  2.3.2.2.3.12 

firecti  weapon  ready 

Section  2.3.2.2.3.10 

ammo  misfire  lock  status 

Section  2.3.5.1.54 

repair  _fix  failure 

Section  2.5.4.19.5 

Table  2.3-99: 
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2. 3. 3. 2. 5  weapons_simul 


This  routine  perforais  the  tick-by-tick  simulation  of  the  weapons. 


1  Internal  Variables  1 

Internal  Variable 

Where  Tvoedef  Declared 

i 

int 

Standard 

found  missile 

int 

Standard 

vehicle  movina 

int 

Standard 

VECTOR 

Sim  tvpes.h 

I  Calls  1 

Function 

Where  Described 

tow  fired  check 

Section  2.3.3.2.2 

vec  mat_mul 

Section  2.6.2.56.1 

vec  add 

Section  2.6.2.57.1 

kinematics  aet  h  to  w 

Section  2.5.8. 1.2 

kinematics  aet  o  to  h 

Section  2. 5. 8. 1.4 

drivetrain  aet  vehicle  speed 

Section  2.3.6.2.4.8 

missile  tow  cut  wire 

Section  2.5.3.13.5 

missile  tow  fly 

Section  2.5.3.13.3 

Table  2.3-100:  weapons^simul  Information. 


2. 3. 3. 2. 6  weaponsjnit 


This  routine  initializes  the  weapons  system. 


1  Internal  Variables  1 

Internal  Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard 

time  temp 

Iona 

Standard 

Calls 

Function 

Where  Described 

missile  tow  init 

Section  2.5.3.13.1 

missile  util  init 

Section  2.5.3.27.1 

Table  2.3-101:  weapons  init  Information. 


2.33.2.7  wea  pons_set_low_fi  re_rate 

This  routine  is  called  from  the  CIG  and  Handles  modules.  It  sets  the  multi  shot  mode  flag  to 
TRl  E,  signifying  that  the  weapon  is  in  multi-shot  mode. 


746 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


2. 3. 3. 2. 8  weapons_trigger_is_released 
This  routine  releases  the  trigger. 

2. 3. 3. 2. 9  weapons_cut_any_tow_wires 
This  routine  cuts  any  tow  wires. 


1  Internal  Variables  1 

Internal  Variable 

Where  Tvpedef  Declared 

i 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

missile  tow  cut  wire 

Section  2.5.3.13.5 

Table  2.3-102:  weapons_cut_any_tow_wires  Information. 

2.3.3.2.10  weapons_set_high_fire_rate 

This  routine  sets  highjire_rate  and  multi _shot_mode  equal  to  TRUE,  signifying  that  the 
weapon  is  in  high  fire  multi-shot  mode. 

2.3.3.2.11  weapons_set_singIe_shot_mode 

This  routine  sets  multi  jhotjnode  equal  to  FALSE,  signifying  that  the  weapon  is  in  signle 
shot  mode. 


2.3.3.2.12  weapons_trigger_is_pulled 

This  routine  sets  trigger  Js  j}ulled  equal  to  TRUE,  signifying  that  the  trigger  is  pulled. 

2.3.3.2.13  wea pons_t rigger_status 


This  routine  returns  the  trigger  status. 


1  Return  Values  1 

Return  Value 

Type 

Meanina 

triggerJsjDulled 

int 

If  equal  to  TRUE,  the  trigger  is 
pulled; 

if  equal  to  FALSE,  the  trigger 
is  released. 

Table  2.3-103:  weapons_trigger_status  Information. 
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2.3.3.2.14  weapons_shot_misfired 
This  routine  causes  a  shot  misfire  failure. 

2.3.3.2.15  weapons_break_tow_launcher 
This  routine  causes  the  tow  launcher  to  fail. 


Vehicles  CSQ 


2.3.3.2.16  weapons_repai r_tow_launcher 
This  routine  repairs  the  tow  launcher. 


2.3.3.2.17  weapons_misfire_corrected 
This  routine  repairs  a  weapons  misfire. 


1  Calls  1 

Function 

Where  Described 

ammo  misfire  corrected 

Section  2.3.5.1.58 

Table  2.3-104:  weapons_misfire_corrected  Information. 


2.3.3.2.18  weapons_vehicle_roIled 

This  routine  is  not  used  in  the  version  6.6  release. 


2.3.3.2.19  weapons_vehicle_unroned 
This  routine  is  not  used  in  the  version  6.6  release. 


2.3.3.2.20  weapons_download_ballistics_tabIes 

This  routine  downloads  the  ballistics  trajectory  data  file  for  the  ammo  types  used  in  the  M2 
tank. 


I  Calls  I 

Function 

Where  Described 

ballistics  load  trajectory  file 

Section  2.5.2.3.1 

Table  2.3-105:  weapons_downIoad_ballistics_tables  Information. 
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2.3.3.2.21  weapons_keybrd_fire 

This  routine  fires  a  round,  responding  to  a  command  from  the  keyboard. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

ammo 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

weapons  fire  round 

Section  2.3.3.2.3 

Table  2.3-106;  weapons_keybrd_fire  Information. 
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2.3.4  M2  Failures 

Failure  generation  in  SIMNET  allows  the  introduction  of  simulated  physical  failures  and 
degradations  of  a  vehicle's  capabilities.  This  involves  the  generation  of  a  variety  of  different 
kinds  of  failures  and  the  presentation  of  these  failures  to  either  the  crew  of  a  manned  simulator, 
or  the  operator  of  a  computer  controlled  vehicle.  Failures  are  divided  into  categories  that 
indicate  the  method  used  for  failure  generation.  The  three  categories  are  combat  damage, 
stochastic  failure,  and  deterministic  failure. 

Combat  Damage 

During  combat,  a  vehicle  receives  combat  information  messages  from  the  netwwk.  This 
information  comes  in  two  different  forms.  First,  an  impact  message  tells  the  vehicle  that 
someone  has  been  hit  by  an  incoming  direct  fire  round  or  missile  (both  referred  to  as  a  round). 
If  the  round  struck  another  vehicle,  then  the  message  is  ignored  for  purposes  of  combat 
damage.  The  vehicle  stmek  by  the  round  uses  the  information  in  the  message  to  calculate  any 
damages  that  may  result.  Second,  an  indirect  fire  message  tells  the  vehicle  that  an  indirect  fire 
round  has  exploded.  The  impact  point  is  checked  to  determine  if  the  impact  was  close  enough 
to  damage  the  vehicle. 

Stochastic  Failures 

A  stochastic  failure  occurs  when  a  vehicle  fails  on  its  own  and  not  because  of  a  crew  error  or 
due  to  combat  damage.  The  frequency  of  failure  is  determined  by  a  Mean  Number  of 
Operations  Between  Failures  (MNOBF).  Stochastic  failures  can  degrade  functions  or  can 
serve  as  a  warning  for  potential  deterministic  failures. 

Deterministic  Failures 

Deterministic  failures  are  those  failures  which  result  from  some  improper  action  by  the  crew 
that  generally  could  have  been  prevented.  These  include  both  failures  due  to  resource  depletion 
and  failures  due  to  crew  error.  Examples  of  these  errors  include  mismanaging  fuel  and 
ammunition,  ignoring  warning  lights,  and  throwing  a  track  while  driving  ^e  vehicle  across  a 
hill  with  too  great  a  slope. 


Figure  2.3-5:  Structure  of  the  M2  P'ailurcs  CSC. 


750 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


The  CSU's  listed  below  provide  the  routines  for  failure  simulation. 


m2_failure.c 

m2_repair.c 


2. 3. 4.1  m2_failure.c 

(./siinnei/release/src/vehicle/m2/src/m2_failure.c  [m2_failure.c]) 


The  vehicle  specific  failures  functions  are  found  in  this  CSU, 
Includes: 


stdio.h" 

"bigwheel.h" 

’math.h" 

"libsound.h" 

'sim_types.h" 

"libmain.h" 

'sim_dfns.h" 

’'librva.h" 

'sim_macros.h" 

"m2_cntrl.h" 

'pro_sim.h" 

"m2_dtrain.h" 

'mun_type.h" 

"m2_elecsys.h" 

'pro_data.h" 

”m2_engine.h" 

’mass_stdc.h" 

"m2  engfail.h" 

'dgi_stdg.h" 

"m2_failure.h" 

'sim  cig_if.h" 

"m2_fuelsys.h" 

'UbfaiLh" 

"m2_handles.h" 

'faUure.h" 

"m2_sound_dfn.h 

’status.h" 

"m2_trans.h" 

'status_in2.h" 

"m2_turret.h" 

'repair_m2.h" 

"m2_vision.h" 

libnetwork.h" 

"m2_weapons.h" 

'librepair.h" 

libhulLh" 

”m2_rep_map.h" 

1 
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’  NUM_SUB_SYSTEMS 
MOBILITY_SYSTEM 
FIREPOWER.SYSTEM 
SUPPORT_SYSTEM 
ACTUAL_NUM_LEVELS 
USED_NUM_LEVELS 
MAINT_L_1_MMBF 
MAINT_L_2_MMBF 
MAINT_L_3_MMBF 
MAINT_L_4_MMBF 
MAINT_L_5_MMBF 


Declarations: 

MAINT_LEVEL_ARRAY 

2. 3. 4. 1.1  fail_init 

This  routine  initializes  the  failures  system.  The  combat  failures  and  combat  failure  table  are 
initialized,  and  the  stochastic  failures  and  stochastic  damages  table  are  initialized.  The  repairs 
are  initialized  and  the  collision  damages  are  initialized. 


\  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

fialure  collision  damages 

int 

Standard 

Calls 

Function 

Where  Described 

failure  collision  damages 

Section  2.3.4. 1.2 

cfail  init 

Section  2.5.4.5.1 

fail  table  init 

Section  2.5.4.11.1 

sfail  init 

Section  2.5.4.23.1 

get  sdamage  file 

Section  2.5.1. 2.7 

Irepair  init 

Section  2.5.4.19.1 

collision  init 

Section  2.5.10.5.1 

Table  2.3-107:  fail  init  Information. 
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f 


2. 3. 4. 1.2  failure_collision_dainages 

This  routine  is  called  by  the  collision  code  when  a  collision  is  detected.  Parameters  are 
represented  as  follows: 

direction  -  The  direction  the  collision  came  from:  RIGHT_WHEEL, 

LEFT_WHEEL,  or  REAR_WHE^,  as  defined  in 
/simnet/vehicle/libbigwh/bigwhjoc.h 

cause  —  The  cause  of  the  collision,  cause  can  be  either  a  hash  id  corresponding 

to  the  vehicle  collided  with  or  -2  (signifying  a  ground  collision) 
event  id  -  The  event  id  corresponding  to  the  collision 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

direction 

int 

Standard 

cause 

int 

Standard 

event  id 

Iona  int 

Standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

vid 

pointer  to  VehiclelD 

basic.h 

1  Return  Values  1 

Return  Value 

Type 

Meanina 

0 

int 

Successful 

1  Calls  1 

Function 

Where  Described 

sound  make  const  sound 

Section  2. 1.3.1. 2 

rva  net  veh  id 

Section  2.5.12.10.1 

turret  collision  detected 

Section  2.3.6.1.1.25 

network  send  outta  my  wav  mf 

Section  2. 1.1. 3. 1.8.1 

Table  2.3-108:  failure_colIision_damages  Information. 
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2.3.4. 1.3  failure_check_cat_kill 

Tlus  routine  dbecks  to  see  if  a  direct  impact  packet  came  from  a  mine.  If  the  packet  is  from  a 
mine,  then  the  tank  is  destroyed.  If  the  packet  is  not  from  a  mine,  then  damages  are  calculated 
by  calling  cfaMl_dir_fire_damages()  in  libfail.  Parameters  are  represented  as  follows: 

ammo  jype  -  the  ammo  indix  from  libmap 

hitjnsg  -  pointer  to  the  Impact  Variant  PDU 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

hit  msQ 

pointer  to  ImpactVariant 

p  sim.h 

ammo  tvoe 

int 

Standard 

Calls 

Function 

Where  Described 

fail  vehicle  is  ^destroved 

Section  2.5.4.9.2 

cfail  dir  fire  daFi^maqes 

Section  02.5.4.3.1 

Table  2.3-109:  fanure_check_cat_kill  Information. 
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2. 3. 4. 1.4 


failure_check_indir_fire_damages 


This  routine  checks  to  see  if  an  indirect  impact  packet  came  from  a  mine.  If  the  packet  is  from 
a  mine  and  the  detonation  occurs  within  10  meters  of  the  tank,  then  the  tank  is  destroyed.  If 
the  packet  is  not  from  a  mine,  then  damages  are  calculated  by  calling 
cfail_indirect_fire_dainages()  in  libfail.  Parameters  are  represented  as  follows: 


ammojype 
indir Jirejnsg 
rsqmred 
detonationjium 


—  the  ammo  indix  from  libmap 

“  pointer  to  the  Indirect  Fire  Variant  PDU 
"  The  range  from  the  detonation  to  the  vehicle 

-  The  detonation  number  within  the  Indirect  Fire  Variant  PDU 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

ammo  type 

int 

Standard 

indir  fire  msa 

pointer  to  IndirectFireVariant 

p  sim.h 

r  squared 

REAL 

sim_.  types,  h 

detonation  num 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

fail  vehicle  is  destroyed 

Section  2.5.4.9.2 

cfail  indirect  fire  damages 

Section  2.5.4.4.1 

kinematics  qet  h  to  o 

Section  2.5.8. 1.3 

kinematics,  get  w  to  h 

Section  2.5.8. 1.1 

Table  2.3-110:  failure_check_indlr_fire_damages  Information. 
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2. 3. 4. 2  in2_repair.c 

(./sininei/release/src/vehicle/ni2/src/m2_repair.c  [m2_repair.c] ) 
The  M2  specific  repairs  functions  are  found  in  this  CSU. 


Includes: 

"stdio.h" 

"sim_dfns.h" 

"sim_macros.h" 

"sim_types.h" 

"pro_assoc.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 


"pro_data.h" 

"pro_sim.h" 

"repair_m2.h" 

"timers_dfn.h" 

"timers.h" 

"libnetwork.h" 

"m2_cntrl.h" 

"m2_resupp.h" 


Defines; 

QUIET 

REQUEST 

MAX_REPAIR_ENTrnES 

Declarations: 

repair_vehicle 

repair_vehicles_near_hear 

num_repair_vehicles 

repair_state 

repair.timerjd 

clear_repair_vehicles() 

repair_quietjstate() 

repair~requ^t_state() 

send_feed_me”packets_repair_vehicles() 
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2. 3. 4. 2.1  repair_request 

This  routine  processes  repair  requests  that  come  in  over  the  network  from  the  Admin/Log 
console  of  the  MCC.  The  MCC  host  times  these  repairs  and  informs  the  simulator  that  the 
repair  is  complete  via  a  network  message. 


1  Parameters  1 

Parameter 

Where  Tvoedef  Declared 

event 

int 

Standard 

aaent 

pointer  to  VehiclelD 

basic.h 

code 

int 

Standard 

oriqinator 

pointer  to  SimulationAddress 

address.h 

tid 

T  ransaction  Identifier 

p  assoc,  h 

1  Errors  I 

Error 

Reason  for  Error 

stderr,  REPAIR:  repair  requestO 

unknown  repair  state 

1  Calls  1 

Function 

Where  Described 

timers  free  timer 

Section  2.6.3.5.1 

repair  system  is  fixed 

Section  2.5.4.19.4 

send  repaired  pkt 

Section  2.1.1.3.1.38.1 

Table  2.3-111:  repair_request  Information. 

2. 3. 4. 2. 2  repair_simul 

This  routine  runs  the  repair  simulation  and  is  responsible  for  all  self-repairs  to  the  simulation 
The  routine  checks  the  vehicle's  repair  state  and  calls  the  appropriate  routine  for  that  state. 


1  Errors  1 

Error 

Reason  for  Error 

stderr.  REPAIR:  repair  simulO 

unknown  repair  state 

Calls 

Function 

Where  Described 

repair  quiet  state 

Section  2.3.4. 2. 7 

repair  request  state 

Section  2.3.4. 2.8 

clear  repair  vehicles 

Section  2.3.4. 2.4 

Table  2.3-112:  repair_simul  Information. 
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2. 3. 4. 2. 3  repair_init 

This  routine  initializes  the  repair  simulation.  All  repair  vehicles  are  cleared,  the  repair  state  is 
set  to  QUIET,  and  the  repair  timer  is  set  to  NULL_TIMER. 


1  Calls  1 

Function 

Where  Described 

clear  repair  vehicles 

Section  2.3.4.2.4 

Table  2.3-113:  repair_init  Information. 

2. 3. 4. 2. 4  clear_repair_vehicles 

This  routine  clears  the  repair _yehicles  near  here  flag  to  FALSE  and  the  number  of  repair 
vehicles  to  zero. 

2. 3. 4. 2. 5  repair_near_repair 

This  routine  maintains  the  list  of  close  vehicles  which  are  repair  vehicles.  If  any  repair  vehicles 
are  on  this  list,  the  repair _\ehicles_near_here  flag  is  set  to  TRUE. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

V 

pointer  to  VehiclelD 

basic. h 

Table  2.3-114:  repair_near_repair  Information. 

2. 3. 4. 2. 6  send_feed_me_packets_repair_vehicles 

This  routine  sends  a  repair  request  packet  to  each  of  the  repair  vehicles  on  the  network. 


Internal 

Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard 

Calls 

Function 

Where  Described 

network  send  feed  me  packet 

Section  2.1.1.3.1.48.1 

Table  2.3-115;  send_feed_me_packets_repair_vehicles  Information. 
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2. 3. 4. 2. 7 


repair_quiet_state 


This  routine  determines  the  vehicle's  repair  Finite  State  Machine's  QUIET  state.  If  the 
following  conditions  are  BOTH  TRUE: 

•  The  resupply  gating  conditions  are  TRUE  (the  vehicle  is  alive,  the  vehicle  is  not 
moving,  and  no  controls  failures  exist). 

•  There  are  repair  vehicles  nearby. 

Then,  send  a  feed  me  packet  to  the  repair  vehicles  on  the  network,  start  the  repair  timer,  and 
enter  the  REQUEST  state.  If  any  of  the  conditions  are  not  met,  remain  in  the  QUffiT  state. 


1  Return  Values  1 

Return  Value 

Meaning 

QUIET 

int 

The  vehicle  is  in  the  repair 

FSM  QUIET  state 

REQUEST 

int 

The  vehicle  is  in  the  repair 

FSM  REQUEST  state 

1  Calls  1 

Function 

Where  Described 

resupply  gatinq  conditions 

Section  2.3.5.3.15 

timers  get  timer 

Section  2.6.3.6.1 

send  feed  me  packets  repair  vehicles 

Section  2.3.4.2.6 

Table  2.3-116:  repair_quiet_state  Information. 


2. 3. 4. 2. 8 


repair_request_state 


This  routine  determines  the  vehicle's  repair  Finite  State  Machine's  REQUEST  state.  If 
EITHER  of  the  following  conditions  are  TRUE: 

•  The  resupply  gating  conditions  are  FALSE  (the  vehicle  is  dead,  the  vehicle  is 
moving,  or  a  controls  failure  exists). 

•  There  are  no  fuel  carriers  nearby. 

Then,  free  the  repair  timer  and  enter  the  (JUIET  state.  If  none  of  the  conditions  are  met  and  the 
resupply  timer  has  expired,  send  another  service  request,  restart  the  timer,  and  remain  in  the 
REQUEST  state.  If  the  resupply  timer  has  not  expired,  remain  in  the  REQUEST  state. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

QUIET 

int 

The  vehicle  is  in  the  repair 

FSM  QUIET  state 

REQUEST 

int 

The  vehicle  is  in  the  repair 

FSM  REQUEST  state 

1  Calls  1 

■  Function 

Where  Described 

Section  2.3.5.3.15 

timers  get  timer 

Section  2. 6. 3. 6.1 

send  feed  me  packets  repair  vehicles 

Section  2.3.4.2.6 

Table  2.3-117:  repair_request_state  Information. 
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2. 3. 4. 2. 9  print_repair_status 

This  routine  prints  the  repair  status  information. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

s 

pointer  to  char 

Standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

i 

int 

Standard 

Table  2.3*118:  print_repair_status  Information. 
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2.3.5  M2  Munitions  Management 


Figure  2.3-6:  Structure  of  the  M2  Munitions  Management  CSC. 

The  simulation  monitors  fuel  and  ammunition  in  the  above  files.  The  fuel  system  involves 
more  than  one  fuel  tank,  and  the  fuel  may  transfer  between  these  tanks  within  the  vehicle. 
The  simulation  must  also  determine  the  states  of  all  munitions  on  board  a  vehicle.  This 
includes  the  availability,  which  ammunitions  are  loaded,  and  which  ammunition  is  being 
fired.  Resupply  of  all  munitions  (fuel  and  ammunition)  is  coordinated  in  the  file 
"m2_resupp.c"  for  the  associated  vehicles.  These  files  implement  the  functions  necessary 
to  resupply  munitions  from  MCC  vehicles  (hemmits,  etc.)  and  other  vehicle  simulations 
(ml  to  ml,  m2  to  m2). 

The  following  CSU's  provide  this  functionality. 

m2_ammo.c 

m2_fuelsys.c 

m2_resupp.c 
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2.3.5. 1  in2_amino.c 

(./simnet/release/src/vehicle/m2/src/m2_animo.c  [m2_ammo.c]) 

This  CSU  monitors  the  M2’s  ammunition  supply. 

Includes: 

"stdio.h" 

"sim_dfns,h" 

"sim_macros.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgLstdg.h" 

"sim_cig_if.h" 

"timers_dfn.h" 

"timers.h" 

"libnetwork.h" 

"libsound.h" 

"failure.h" 

"libfail.h" 

"m2_alpha.h’’ 

"m2_alpha_df.h" 

"m2_ammo.h" 

"m2_ammo_df.h" 

"m2_turr_mx.h" 

"m2_turr_pn.h" 

"m2_cntrl.h" 

"ni2_cU_df.h" 

"m2_launcher.h" 

"m2_resupp.h" 

"ni2_sound_dfn.h" 

"m2_tmrs_df.h" 

"m2_weapons.h" 

"m2_isu.h" 

"m2_turret.h" 

"m2_bcs.h" 

’’m2_firectl.h" 

"mun_type.h" 

Static  Variable  and  Procedure  Declarations: 

Note  that  the  hei  and  apds  ammunition  cans  are  stored  as  a  sequence  of  bits: 

AP  ==  0,  HE  ==  1,  where  each  bit  represents  a  box  of  30  rounds.  The  Least  Significant 
Bit  represents  the  box  closest  to  the  barrel,  and  the  Most  Significant  Bit  represents  the  box 
farthest  away  from  the  barrel. 

apds_can_quantity 

apds_can_ammo_boxes 

hei_can_quantity 

hei_can_ammo_boxes 

apds„stowed_quantity 

hei_stowed_quantity 

tow  stowed_quanity 

dragon_stowed_quantity 
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missile  l_val 
missile2_val 
in3_configuration_val 

n_25_stowed 

n_missile_stowed 

n_dragon_stowed 

displayed_stowed_quantity 

hei_can_switch_val 

apds_can_switch_val 

ammo_reversed_val 

tow_launcher_val 

gps_mag_val 

bolt_position 

ammo_round_selected 

ammo_round_loaded 

ammo_round_indexed 

ainmo_round_chambered 

ammo_round_last_selected 

ammo_misfire_lock 

low_ammo_val 

low  _ammo_lock_val 

tow_test_in_progress 

tow_test_val  -  Where  0.0  ==  BEGIN  and  1.0  ==  END 

missile  l_selected 

missile2_selected 

ammo_transfer_status  --  For  AMMO_RECIEVE_VAL,  an 

ammunition  transfer  receive  is  valid;  for 
AMMO_SEND_VAL,  the  ammunition 
transfer  send  is  valid;  for 
AMMO_NO_TRANSFER_VAL,  no 
ammunition  transfer  is  valid;  for 
AMMO_INTERNAL_VAL,  an  internal 
ammunition  transfer  is  valid;  for  AMMO 

ammo_mgmt_round 

resupply_counter 

intemal_resupply_in_progress 

ammo_reversed_check() 

ammo3indexed_check() 

ammo~tow_test_check() 

ainmo~low_ammo_check() 

ammo”tow_test_start() 

ammo”two_tesr  stopO 

ammo”get_missTleJoaded() 

ammo”get_apds_can  first_round() 

ammo~get_hei_can_frrst_round() 

ammo_remove“apds_can_round() 

ammo”remove_hei_can_round() 

ammo”get_a  pds_can_box() 

ammo3get~hei_can_box() 

ammo”hei_can_enoligh_room() 


763 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


ammo_apds_can_enough_rooin() 

ammo~25inm_stowage_enough_rooin() 

ammo”two_tirbes_enough_room() 

ainmo~tow~stowa'ge_enough_room() 

ainmo~dragbn_stowage_enough_rooin() 

amino~resupply_timeout_check() 

ainino~ready  to_internarresupply() 

ainmo~sta*‘t_'nternal_resuppIyO 

ainmo~internaI_resuppIy_start_check() 

amino3nternal~resuppIy~abort_check() 

ainmo_roundsjon_board~check() 

ammo~hel_stowage_enough_supply() 

animo~apds_stowage_enough_supply() 

ammo3ow_stowage_enough_supply() 

ammo_supply_empty_stowa^() 

2. 3. 5. 1.1  ainmo_init 

This  routine  initalizes  the  ammo  system. 


1  Calls  1 

Function 

Where  Described 

controls  bolt  position  sear 

Section  2.3.2 

fail  init  failure 

Section  2.5.4.11.2 

Table  2.3>119:  ainmo_init  Information. 

2.3.5. 1.2  ammo_simul 

This  routine  simulates  the  various  functions  of  the  ammunition  system  on  a  tick  by  tick 
basis.  The  routine  checks  the  status  of  any  internal  or  external  ammunition  transfers  or 
resupplies.  The  routine  monitors  the  types  and  quantities  of  ammo  in  location. 


I  Calls  I 

Function 

Where  Described 

ammo  reversed  check 

Section  2.3.5.1.29 

ammo  indexed  check 

Section  2.3.5.1.31 

ammo  tow  test  check 

Section  2.3.5.1.46 

ammo  low  ammo  check 

Section  2.3.5.1.49 

ammo  internal  resupply  start  check 

Section  2.3.5.1.87 

ammo  internal  resupply  abort  check 

Section  2.3.5.1.88 

ammo  resupply  timeout  check 

Section  2.3.5.1.89 

ammo  rounds  on  board  check 

Section  2.3.5.1.90 

Table  2.3-120:  ammo  simul  Information. 
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2. 3. 5. 1.3  ammo_init_ammo_supply 

This  routine  initializes  the  ammo  system's  ammunition  supply.  The  routine  determines 
whether  the  tank  is  configured  as  an  M2  or  an  M3.  The  values  which  are  passed  for  ammo 
supply  quanitites  are  compared  to  the  maximum  numbers  allowed  for  the  tank  configuration 
to  make  sure  that  the  tank  is  not  supplied  with  more  ammo  than  it  is  allowed. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

temp  apds  can  quantity 

int 

Standard 

temp_apds_can_ammo_ 

boxes 

int 

Standard 

int 

Standard 

temp_apds_can_ammo_ 

boxes 

int 

Standard 

temp  apds  stowed  quantity 

int 

Standard 

temp  hei  stowed  quantity 

int 

Standard 

temp  tow  stowed  quantity 

int 

Standard 

temp_dragon_stowed_ 

quantity 

int 

Standard 

temp  missiiel  val 

int 

Standard 

temp  missile2  val 

int 

Standard 

temp  m3  configuration  val 

int 

Standard 

Table  2.3-121:  ammo_init_ammo_supply  Information. 


2 . 3 . 5 . 1 . 4  ammo_get_apds_can_quantity 

This  routine  returns  the  quantity  of  armor  piercing  discarding  sabot  (apds)  canisters  in  the 
tank. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

apds_can_quantity 

int 

Quantity  of  apds  cans  in  the 
tank. 

Table  2.3-122:  ammo_get_apds_can_quantity  Information. 


2 . 3 . 5 . 1 . 5  ammo_get_apds_can_ammo_boxes 


This  routine  returns  the  quantity  of  apds  canisters  in  the  two  ammunition  boxes. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

apds_can_ammo_boxes 

int 

Quantity  of  apds  cans  in  the 
ammo  boxes. 

Table  2.3-123:  ammo_get_apds_can_ammo_boxes  Information. 
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2 . 3 . 5 . 1 . 6  ainino_get_hei_can_quantity 

This  routine  returns  the  quantity  of  high  explosive  anti  tank  (hei)  canisters  in  the  tank. 


1  Return  Values  1 

Return  Value 

Meanina 

heLcanjquantity 

int 

Quantity  of  hei  cans  in  the 
tank. 

Table  2.3-124:  ammo_get_hei_can_quantity  Information. 
2 . 3 . 5 . 1 . 7  ammo_get_hei_can_ammo_boxes 

This  routine  returns  the  quantity  of  hei  canisters  in  the  two  ammunition  boxes. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

heLcan_ammo_boxes 

int 

Quantity  of  hei  cans  in  the 
ammo  boxes. 

Table  2.3-125:  ammo_get_hei_can_ammo_boxes  Information. 
2 . 3 . 5 . 1 . 8  ammo_get_apds_stowed_quanti  ty 
This  routine  returns  the  quantity  of  apds  in  stowage. 


1  Return  Values  1 

Return  Value 

Meanina 

apds  stowed  quantity 

int 

Quantity  of  apds  in  stowage. 

Table  2.3-126:  ammo_get_apds_stowed_quantity  Information. 
2 . 3 . 5 . 1 . 9  ammo_get_hei_stowed_quantity 

This  routine  returns  the  quantity  of  hei  in  stowage. 


I  Return  Values  1 

Return  Value 

Type 

Meanina 

hei  stowed  quantity 

int 

Quantity  of  hei  in  stowaqe. 

Table  2.3-127:  ammo_get_hei_stowed_quantity  Information. 
2.3.5.1.10  ammo_get_tow_stowed_quanti ty 

This  routine  returns  the  number  of  TOW  missiles  in  stowage. 


1  Return  Values  1 

Return  Value 

Meaning 

tow_stowed_quantity 

int 

Quantity  of  TOW  missiles  in 
stowaqe. 

Table  2.3-128:  ammo_get_tow_stowed_quantity  Information. 
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2.3.5.1.11  ammo_get_dragon_stowed_quantity 
This  routine  returns  the  number  of  Dragon  missiles  in  stowage. 


1  Return  Values  I 

Return  Value 

Meaning 

dragon_stowed_quantity 

int 

Quantity  of  Dragon  missiles  in 
stowage. 

Table  2.3-129:  ammo_get_dragon_stowed_quantity  Information. 
2.3.5.1.12  ammo_get_missilel_val 
This  routine  returns  whether  the  missile  1  launcher  is  being  used. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

missile1_val 

int 

If  0,  missile  1  tube  is  invalid; 

If  1 ,  missile  1  tube  is  valid. 

Table  2.3-130:  ammo_get_missilel_val  Information. 


2.3.5.1.13  ammo_get_missile2_val 

This  routine  returns  whether  the  missile  2  launcher  is  being  used. 


I  Return  Values  I 

Return  Value 

Type 

Meaning 

missile2_val 

int 

If  0,  missile  2  tube  is  invalid; 

If  1 ,  missile  2  tube  is  valid. 

Table  2.3-131:  ammo_get_missiIe2_val  Information. 
2.3.5.1.14  ammo_get_m3_con figu ration_val 

This  routine  returns  whether  the  vehicle  is  configured  as  an  M2  or  an  M3  vehicle. 


1  Return  Values  1 

Return  Value 

Meaning 

m3_configuration_val 

int 

If  0,  vehicle  is  an  M2; 

If  1 ,  vehicle  is  an  M3. 

Table  2.3-132:  ammo_get_apds_can_quantity  Information. 
2.3.5.1.15  ammo_hei_can_hei_on 

When  the  hei  ammo  box  switch  is  set  to  hei,  this  routine  sets  the  value  of 
hei_can_switch_val  equal  to  munition_US_M792,  This  signifies  that  the  hei  ammo  box 
contains  hei  rounds. 
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2.3.5.1.16  ammo_hel_can_hei_off 

When  the  hei  ammo  box  switch  is  set  to  apds,  this  routine  sets  the  value  of 
hei_can_switch_yal  equal  to  munition_US_M791 .  This  signifies  that  the  hei  ammo  box 
contains  apds  rounds. 

2.3.5.1.17  ammo_apds_can_hei_on 

When  the  apds  ammo  box  switch  is  set  to  hei,  this  routine  sets  the  value  of 
apds_can_switch_val  equal  to  munition_US_M792.  This  signifies  that  the  apds  ammo  box 
contains  hei  rounds. 

2.3.5.1.18  ammo_apds_can_hei_off 

When  the  apds  ammo  box  switch  is  set  to  apds,  this  routine  sets  the  value  of 
apds_can_switch_val  equal  to  munition_US_M791 .  This  signifies  that  the  apds  ammo 
box  contains  apds  rounds. 

2.3.5.1.19  ammo_mgmt_receive_pushed 

This  routine  sets  the  ammo  transfer  status  when  the  Ammunition  Management  Receive 
button  is  pressed.  Any  type  of  resupply  in  progress  is  stopped.  If  a  resupply  receive  was 
already  in  progress,  it  is  discontinued  and  the  transfer  status  is  set  to 
AMMO_NO_TRANSFER_VAL.  Otherwise,  the  receive  is  enabled  by  setting  transfer 
status  to  AMMO_RECEIVE_VAL. 


1  Calls  1 

Function 

Where  Described 

ammo  stop  resupply 

Section  2.3.5.1.76 

Table  2.3-133:  ammo_mgmt_receive_pushed  Information. 
2.3.5.1.20  ammo_mgmt_send_pushed 

This  routine  sets  the  ammo  transfer  status  when  the  Ammunition  Management  Send  button 
is  pressed.  Any  type  of  resupply  in  progress  is  stopped.  If  a  resupply  send  was  already  in 
progress,  it  is  discontinued  and  the  transfer  status  is  set  to 

AMMO_NO_TRANSFER_VAL.  Otherwise,  the  send  is  enabled  by  setting  the  transfer 
status  to  AMMO_SEND_VAL. 


I  Calls  I 

■  Function 

Where  Described 

Section  2.3.5.1.76 

Table  2.3-134:  ammo_nigmt_send_pushed  Information. 
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2.3.5.1.21 


amino_ingint_internal_pushed 


This  routine  sets  the  ammo  transfer  status  when  the  Ammunition  Management  Internal 
button  is  pressed.  Any  t}^e  of  resupply  in  progress  is  stopped.  If  a  internal  ammo  transfer 
was  already  in  progress,  it  is  stopped  and  the  transfer  status  is  set  to 
AMMO_NO_TRANSFER_VAL.  Otherwise,  the  internal  transfer  is  enabled  by  setting  the 
transfer  status  to  AMMO_INTERNAL_VAL. 


1  Calls  1 

Function 

Where  Described 

ammo  stop  resuoplv 

Section  2.3.5.1.76 

Table  2.3-135:  ammo_mgmt_internaI_pushed  Information. 
2.3.5.1.22  ammo_mgmt_hei_pushed 


This  routine  causes  ammo  from  the  hei  box  to  be  transferred  when  the  Ammunition 
Management  HE  button  is  pressed  and  either  the  Send,  Receive,  or  Internal  pushbutton 
lamp  is  on. 


1  Calls  1 

1  Function 

Where  Described 

Section  2.3.5.1.76 

Table  2.3-136:  ammo_mgmt_hei_pushed  Information. 
2.3.5.1.23  ammo_mgmt_apds_pushed 

This  routine  causes  ammo  from  the  apds  to  be  transferred  when  the  Ammunition 
Management  AP  button  is  pressed  and  either  the  Send,  Receive,  or  Internal  pushbutton 
lamp  is  on. 


I  Calls  I 

■  Function 

Where  Described 

Section  2.3.5.1.76 

Table  2.3-137:  ammo_mgmt_apds_pushed  Information. 
2.3.5.1.24  ammo_mgmt_tow_pushed 

This  routine  causes  TOW  missiles  to  be  transferred  when  the  Ammunition  Management 
TOW  button  is  pressed  and  either  the  Send,  Receive,  or  Internal  pushbutton  lamp  is  on. 


1  Calls  i 

Function 

Where  Described 

ammo  stop  resupply 

Section  2.3.5.1.76 

Table  2.3-138:  ammo_mgmt_tow_pushed  Information. 


769 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


2.3.5.1.25  ammo_mgmt_dragon_pushed 

This  routine  causes  dragon  missiles  to  be  transferred  when  the  Ammunition  Management 
DRAGON  button  is  pressed  and  either  the  Send,  Receive,  or  Internal  pushbutton  lamp  is 
on. 


1  Calls  1 

■  Function 

Where  Described 

Section  2.3.5.1.76 

Table  2.3-139:  ammo_mgmt_dragon_pushed  Information. 
2.3.5.1.26  ammo_round_selected_status 

This  routine  returns  the  ammo  box  which  the  user  selected  by  pressing  one  of  the 
Ammunition  Management  pushbuttons. 


I  Return  Values  I 

Return  Value 

Type 

Meanina 

(ObjectType) 
ammo  round  selected 

ObjectType 

The  selected  ammo  round. 

Table  2.3-140:  ammo_round_selected_status  Information. 
2.3.5.1.27  ammo  round  loaded  status 


This  routine  returns  the  ammunition  which  is  loaded. 


I  Return  Values  I 

Return  Value 

Meaning 

(ObjectType) 
ammo  round  loaded 

ObjectType 

The  loaded  ammo  round. 

Table  2.3-141:  ammo_round_loaded_status  Information. 
2.3.5.1.28  ammo_round_indexed_status 

This  routine  returns  the  type  of  ammo  round  in  the  selected  ammo  box. 


I  Return  Values  I 

Return  Value 

Meaning 

(ObjectType) 
ammo  round  indexed 

ObjectType 

The  ammo  which  is  in  the 
selected  ammo  box. 

Table  2.3-142:  ammo  round  indexed  status  Information. 
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2.3.5.1.29  ammo_reversed_check 

On  a  tick  by  tick  basis,  this  routine  is  called  to  check  whether  the  ammunition  in  the  ammo 
cans  is  reversed.  If  the  hei  ammo  box  HE/AP  switch  is  in  the  AP  position  (the  box 
contains  apds  rounds),  or  if  the  apds  ammo  box  HE/AP  switch  is  in  the  HE  position  (the 
box  contains  hei  rounds),  the  Ammo  Reversal  Indicator,  located  on  the  Gunner's  Control 
Panel,  will  turn  on. 


1  Calls  1 

Function 

Where  Described 

controls  aunner  ammo  reversed  on 

Section  2.3.2 

controls  qunner  ammo  reversed  off 

Section  2.3.2 

Table  2.3-143:  ammo_reversed_check  Information. 
2.3.5.1.30  ammo_reversed_status 

This  routine  returns  ammo_reversed_v  al.  If  this  flag  is  ON,  either  the  hei  ammo  box 
HE/AP  switch  is  in  the  AP  position  or  the  apds  ammo  box  HE/AP  switch  is  in  the  HE 
position. 


1  Return  Values  1 

Return  Value 

Meanina 

ammo_reversed_val 

int 

If  ON,  the  ammo  is  reversed; 

If  OFF,  the  ammo  is  not 
reversed. 

Table  2.3-144:  ammo  reversed  status  Information. 


2.3.5.1.31  ammo_indexed_check 

On  a  tick  by  tick  basis,  this  routine  is  called  to  check  which  ammo  type  is  contained  in  the 
selected  ammo  box.  Tbe  actual  type  of  ammo  in  the  selected  ammunition  box  is  called  the 
indexed  ammo.  This  routine  notifies  the  ballistics  computer  system  (BCS)  of  the  indexed 
ammo. 


1  Calls  i 

Function 

Where  Described 

bcs  ammo  index  hei  25 

Section  2.3.3. 1 

bcs  ammo  index  apds  25 

Section  2.3.3. 1 

bcs  ammo  index  no  round 

Section  2.3.3. 1 

Table  2.3-145:  ammo  indexed  check  Information. 
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2.3.5.1.32  ammo_ap_ss_pushed 

When  the  AP  Single  Shot  button  is  pushed,  this  routine  causes  the  system  to  be  reset  for 
apds  ammo  in  single  shot  mode.  The  system  cannot  be  reset  if  the  weapon  is  in  the  process 
of  being  fired  already  (the  trigger  is  pulled).  If  the  weapon  is  not  being  fired,  apds  ammo 
is  selected  and  loaded,  and  the  weapon  is  set  for  single  shot  mode. 


1  Calls  1 

Function 

Where  Described 

weapons  triaaer  status 

Section  2.3.3.2.13 

controls  round  select  ap  ss 

Section  2.3.2 

weapons  set  sinqie  shot  mode 

Section  2.3.3.2.11 

isu  round  select  25mm 

Section  2.3.6.3.3.5 

turret  tow  movement  off 

Section  2.3.6.1.1.29 

ammo  tow  test  stop 

Section  2.3.5.1.48 

ammo  qet  apds  can  first  round 

Section  2.3.5.1.62 

Table  2.3-146:  ammo_ap_ss_pushed  Information. 


2.3.5.1.33  ammo_he_ss_pushed 

When  the  HE  Single  Shot  button  is  pushed,  this  routine  causes  the  system  to  be  reset  for 
hei  ammo  in  single  shot  mode.  The  system  cannot  be  reset  if  the  weapon  is  in  the  process 
of  being  fired  already  (the  trigger  is  pulled).  If  the  weapon  is  not  being  fired,  hei  ammo  is 
selected  and  loaded,  and  the  weapon  is  set  for  single  shot  mode. 


1  Calls  1 

Function 

Where  Described 

weapons  triqqer  status 

Section  2.3.3.2.13 

controls  round  select  he  ss 

Section  2.3.2 

weapons  set  single  shot  mode 

Section  2.3.3.2.11 

isu  round  select  25mm 

Section  2. 3. 6. 3.3.5 

turret  tow  movement  off 

Section  2.3.6.1.1.29 

ammo  tow  test  stop 

Section  2.3.5.1.48 

ammo  qet  hei  can  first  round 

Section  2.3.5.1.63 

Table  2.3-147:  ammo  he  ss  pushed  Information. 
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2.3.5.1.34  ammo_ap_lo_pushed 

When  the  AP  Low  Fire  Rate  button  is  pushed,  this  routine  causes  the  system  to  be  reset  for 
apds  ammo  in  low  fire  rate  mode.  The  system  cannot  be  reset  if  the  weapon  is  in  the 
process  of  being  fired  already  (the  trigger  is  pulled).  If  the  weapon  is  not  being  fired,  apds 
ammo  is  selected  and  loaded,  and  the  weapon  is  set  for  the  low  fire  rate. 


Calls  1 

Function 

Where  Described 

weapons  tripqer  status 

Section  2.3.3.2.13 

controls  round  select  ap  'o 

Section  2.3.2 

weapons  set  low  fire  rate 

Section  2.3.3.2.7 

isu  round  select  25mm 

Section  2.3.6.3.3.5 

turret  tow  movement  off 

Section  2.3.6.1.1.29 

ammo  tow  test  stop 

Section  2.3.2.5.1.48 

ammo  get  apds  can  first  round 

Section  2.3.5.1.62 

Table  2.3-148:  ammo_ap_lo_pushed  Information. 

2.3.5.1.35  ammo_he_lo_pushed 

When  the  HE  Low  Fire  Rate  button  is  pushed,  this  routine  causes  the  system  to  be  reset  for 
hei  ammo  in  low  fire  rate  mode.  The  system  cannot  be  reset  if  the  weapon  is  in  the  process 
of  being  fired  already  (the  trigger  is  pulled).  If  the  weapon  is  not  being  fired,  hei  ammo  is 
selected  and  loaded,  and  the  weapon  is  set  for  the  low  fire  rate. 


1  Calls  1 

Function 

Where  Described 

weapons  trigger  status 

Section  2.3.3.2.13 

controls  round  select  he  lo 

Section  2.3.2 

weapons  set  low  fire  rate 

Section  2.3. 3. 2. 7 

isu  round  select  25mm 

Section  2.3. 6.3.3. 5 

turret  tow  movement  off 

Section  2.3.6.1.1.29 

ammo  tow  test  stop 

Section  2.3.5.1.48 

ammo  get.  hei  can  first  round 

Section  2.3.5.1.63 

Table  2.3-149:  ammo_ap_ss_pushed  Information. 
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2.3.5.1.36  ammo_ap_hi_pushed 

When  the  AP  High  Fire  Rate  button  is  pushed,  this  routine  causes  the  system  to  be  reset  foi 
apds  ammo  in  high  fire  rate  mode.  The  system  cannot  be  reset  if  the  weapon  is  in  the 
process  of  being  fired  already  (the  trigger  is  pulled).  If  the  weapon  is  not  being  fired,  apds 
ammo  is  selected  and  loaded,  and  the  weapon  is  set  for  the  high  fire  rate. 


1  Calls  1 

Function 

Where  Described 

weaponsjriaaer  status 

Section  2.3.3.2.13 

controls  round  select  ap  hi 

Section  2.3.2 

weapons,  set  hiph  tire  rate 

Section  2.3.3.2.10 

isu  round  select  25mm 

Section  2.3.6.3.3.5 

turret  tow  movement  off 

Section  2.3.6.1.1.29 

ammo  tow  test  stop 

Section  2.3.5.1.48 

ammo  get  apds  can  first  round 

Section  2.3.6.1.62 

Table  2.3-150:  ammo_ap_hi_pushed  Information. 

2.3.5.1.37  ammo_he_hi_pushed 

When  the  HE  High  Fire  Rate  button  is  pushed,  this  routine  causes  the  system  to  be  reset 
for  hei  ammo  in  high  fire  rate  mode.  The  system  cannot  be  reset  if  the  weapon  is  in  the 
process  of  being  fired  already  (the  trigger  is  pulled).  If  the  weapon  is  not  being  fired,  hei 
ammo  is  selected  and  loaded,  and  the  weapon  is  set  for  the  high  fire  rate. 


1  Calls  1 

Function 

Where  Described 

weapons  trigqer  status 

Section  2.3.3.2.13 

controls  round  select  he  hi 

Section  2.3.2 

weapons  set  high  fire  rate 

Section  2.3.3.2.10 

isu  round  select  25mm 

Section  2.3.6.3.3.5 

turret  tow  movement  off 

Section  2.3.6.1.1.29 

ammo  tew  test  stop 

Section  2.3.5.1.48 

ammo  get  hei  can  first  round 

Section  2.3.5.1.63 

ammo_he_hi_pushed  Information. 
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2.3.5.1.38 


ammo_tow_select_pushed 


When  the  TOW  Select  button  is  pushed,  this  routine  causes  the  system  to  be  reset  for  firing 
a  TOW  missile.  In  order  for  the  TOW  missile  to  be  selected,  the  TOW  launcher  must  be 
on,  the  gunners  primary  sight  must  be  in  12X  magnification,  and  the  weapon  must  not  be 
in  the  process  of  firing,  and  the  TOW  missile  must  not  be  already  selected.  If  these 
conditions  are  met,  the  TOW  missile  is  selected,  the  weapon  is  set  for  single  shot  mode, 
and  the  TOW  test  is  started. 


1  Calls  1 

Function 

Where  Described 

weapons  triaaer  status 

Section  2.3.3.2.13 

controls  round  select  tow 

Section  2.3.2 

weapons  set  sinale  shot  mode 

Section  2.3.3.2.11 

isu  round  select  tow 

Section  2.3.6.3.3.7 

turret,  tow  movement  on 

Section  2.3.6.1.1.30 

ammo  tow  test  start 

Section  2.3.5.1.47 

Table  2.3-152:  ammo_tow_seIect_pushed  Information. 
2.3.5.1.39  ammo_tow_test_pushed 

This  routine  starts  the  TOW  missile  test  when  the  TOW  Test  button  is  pressed.  In  order  for 
the  TOW  test  to  start,  the  TOW  launcher  must  be  on,  the  gunners  primary  sight  must  be  in 
12X  magnification,  the  TOW  missile  must  have  been  selected,  and  the  weapon  must  not 
already  be  in  the  process  of  firing. 


Calls  1 

Function 

Where  Described 

weapons  trigaer  status 

Section  2.3.3.2.13 

ammo,  tow  test  start 

Section  2.3.5.1.47 

Table  2.3-153:  ammo_tow_test_pushed  Information. 
2.3.5.1.40  ammo_missilel_pushed 

When  the  Missile  1  button  is  pushed,  this  routine  causes  the  system  to  be  set  for  firing  a 
missile  from  the  missile  1  tube.  If  the  missile2  tube  was  previous  selected,  any  TOW  wires 
are  cut.  The  TOW  launcher  must  be  up,  the  gunners  primary  sight  must  be  in  12X 
magnification,  and  the  TOW  missile  must  be  selected.  If  these  conditions  are  met,  the 
missile  1  tube  is  selected,  the  missile  is  loaded  into  the  missile  1  tube  and  the  missile  1  tube 
controls  are  activated. 


1  Calls  1 

Function 

Where  Described 

weapons  cut  any  tow  wires 

Section  2.3.3.2.9 

ammo  get  missile  loaded 

Section  2.3.5.1.61 

controls  missile2  off 

Section  2.3.2 

controls  missilel  on 

Section  2.3.2 

controls  missilel  flash 

Section  2.3.2 

Table  2.3-154:  ammo_missilel_pushed  Information. 
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2.3.5.1.41  amino_inissile2_pushed 

When  the  Missile2  button  is  pushed,  this  routine  causes  the  system  to  be  set  for  firing  a 
missile  from  the  missile2  tube.  If  the  missile  1  tube  was  previous  selected,  any  TOW  wires 
are  cut  The  TOW  launcher  must  be  up,  the  gunners  primary  sight  must  be  in  12X 
magnification,  and  the  TOW  missile  must  be  selected.  If  these  conditions  are  met,  the 
missile  1  tube  is  selected,  the  missile  is  loaded  into  the  missile2  tube,  and  the  missile2  tube 
controls  are  activated. 


1  Calls  1 

Function 

Where  Described 

weapons  cut  any  tow  wires 

Section  2.3.3.2.9 

ammo  pet  missile  loaded 

Section  2.3.5.1.61 

controls  missilel  off 

Section  2.3.2 

controls  missile2  on 

Section  2.3.2 

controls  missile2  flash 

Section  2.3.2 

Table  2.3-155:  ammo_inissiIe2_pushed  Information. 

2.3.5.1.42  ammo_tow_launcher_on 

This  routine  turns  on  the  TOW  launcher  by  setting  towJauncher_yal  to  ON. 

2.3.5.1.43  ammo_tow_launcher_off 

This  routine  turns  off  the  TOW  launcher.  towJamcher_val  is  set  to  OFF.  If  the  TOW 
missile  is  the  selected  round,  the  weapon  is  set  to  single  shot  mode,  the  TOW  test  is 
stopped,  the  ammo  is  unloaded,  the  missile  1  and  missile2  tubes  are  unselected,  and  any 
TOW  wires  are  cut. 


1  Calls  1 

Function 

Where  Described 

controls  round  select  no  round 

Section  2.3.2 

weapons  set  single  shot  mode 

Section  2.3.3.2.11 

isu  round  select  no  round 

Section  2.3. 6.3.3. 6 

turret  tow  movement  off 

Section  2.3.6.1.1.29 

ammo  tow  test  stop 

Section  2.3.5.1.48 

weapons  cut  any  tow  wires 

Section  2, 3.3.2. 9 

Table  2.3-156:  ammo  tow  launcher  off  Information. 
2.3.5.1.44  ammo_gps_mag_12x 

This  routine  sets  the  gunners  primary  sight  magnification  value  to  1 2X.  If  firing  a  TOW 
missile,  the  gps  magnification  must  be  12x. 
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2.3.5.1.45  ammo_gps_mag_4x 

This  routine  sets  the  gunners  primary  sight  magnification  value  to  4x.  A  TOW  missile  may 
not  be  fired  with  gps  magnification  of  4x.  If  the  TOW  missile  was  selected,  the  weapon  is 
set  to  single  shot  mode,  &e  TOW  test  is  stopped,  the  ammo  is  unloaded,  the  missile  1  and 
missile2  tubes  are  unselected,  and  any  TOW  wires  are  cut. 


1  Calls  1 

Function 

Where  Described 

controls  round  select  no  round 

Section  2.3.2 

weapons  set  sinale  shot  mode 

Section  2.3.3.2.11 

isu  round  select  no  round 

Section  2.3.6.3.3.6 

turret  tow  movement  off 

Section  2.3.6.1.1.29 

ammo  tow  test  stop 

Section  2.3.5.1.48 

weapons  cut  any  tow  wires 

Section  2.3.3.2.9 

Table  2.3-157:  ammo_gps_mag_4x  Information. 

2.3.5.1.46  ammo_tow_test_check 

On  a  tick  by  tick  basis,  this  routine  is  called  to  check  whether  a  TOW  test  is  in  progress. 
The  TOW  test  is  a  test  of  the  TOW  missile  electrical  circuits.  Controls  are  notified  to  turn 
on  the  TOW  Test  indicator  when  the  TOW  test  is  in  progress,  and  turn  off  the  indicator 
when  the  TOW  test  is  not  in  progress. 


1  Calls  1 

Function 

Where  Described 

electsvs  tow_circuit  open  status 

Section  2.3.6.3.1.16 

controls  tow  test  on 

Section  2.3.2 

controls  tow  test  off 

Section  2.3.2 

Table  2.3-158:  ammo  tow  test  check  Information. 


2.3.5.1.47  ammo_tow_test_start 

This  routine  sets  the  tow_test_in_progress  flag  to  TRUE. 

2.3.5.1.48  ammo_tow_test_stop 

This  routine  sets  the  tow_test_in_progress  flag  to  FALSE. 


I 
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2.3.5.1.49  ammo  low  ammo  check 


This  routine  checks  to  see  if  there  are  sufficient  rounds  of  the  selected  ammunition  round. 
If  the  quantity  of  selected  ammunition  is  equal  to  or  lower  than  the  amount  set  in 
NJLOW_AMMO,  the  low  ammo _yal  is  set  to  TRUE.  If  the  Low  Ammo  button  was  not 
pressed,  the  Low  Ammo  indicator  flashes.  If  the  Low  Ammo  indicator  was  acknowledged 
by  pressing  the  Low  Ammo  button,  the  Low  Ammo  indicator  turns  on  steady.  If  there  are 
sufficient  rounds  of  the  selected  ammo,  the  Low  Ammo  indicator  is  turned  off. 


1  Calls  1 

Function 

Where  Described 

controls  low  ammo  flash 

Section  2.3.2 

controls  low  ammo  on 

Section  2.3.2 

controls  low  ammo  off 

Section  2.3.2 

Table  2.3-159:  ammo_tow_test_check  Information. 
2.3.5.1.50  ammo_low_ammo_pushed 

When  the  Low  Ammo  button  is  pressed  and  there  are  not  sufficient  rounds  of  the  selected 
ammop,  the  low_ammoJock_val  is  set  to  OFF. 


2.3.5.1.51  ammo_Iow_ammo_ready_to_fi  re 

This  routine  returns  FALSE  if  the  vehicle  is  low  on  the  selected  ammo  and  the  Low  Ammo 
button  has  not  been  pressed  in  acknowledgment.  TRUE  is  returned  if  either  the  vehicle  is 
not  low  on  the  selected  ammo  or  the  Low  Ammo  button  has  been  pressed  in 
acknowledgment. 


1  Return  Values  1 

Return  Value 

Meaninq 

TRUE 

int 

Either  the  ammo  is  not  low  or 
the  Low  Ammo  button  has 
been  pressed. 

FALSE 

ini 

The  ammo  is  low  and  the  Low 
Ammo  button  has  not  been 
pressed. 

Table  2.3-160:  ammo_low_ammo_ready_to_fire  Information. 
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2.3.5.1.52  ammo_turret_power_off 

This  routine  is  called  when  turret  power  is  turned  off.  The  weapon  is  placed  in  single  shot 
mode,  any  rounds  are  unselected  and  unloaded,  any  Tow  test  is  stopped,  and  any  TOW 
wires  are  cut. 


1  Calls  1 

Function 

Where  Described 

controls  round  select  no  round 

Section  2.3.2 

weapons  set  sinqle  shot  mode 

Section  2.3.3.2.11 

isu  round  select  no  round 

Section  2.3.6  3.3.6 

turret  tow  movement  off 

Section  2.3.6.1.1.29 

ammo  tow  test  stop 

Section  2.3.5.1.48 

weapons_cut_any_  tow  wires 

Section  2.3.3.2.9 

Table  2.3-161:  amTno_turret_power_off  Information. 
2.3.5.1.53  ammo_bolt_position_status 


This  routine  returns  the  bolt  position. 


1  Return  Vaiues  I 

Return  Vaiue 

Meaning 

bolt  position 

int 

The  position  of  the  bolt. 

Table  2.3-162:  ammo_boIt_posltion_status  Information. 


2.3.5.1.54 


ammo  misfire  lock  status 


This  routine  returns  the  value  of  ammo  jnisfire Jock  (either  OFF  or  ON). 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

ammo_misfire_lock 

int 

If  equal  to  OFF  or  FALSE,  the 
misfire  button  has  not  been 

nrpct^pd' 

If  equal  to  ON  or  TRUE,  the 
misfire  button  has  been 
pressed. 

Table  2.3-163:  ammo  misfire  lock  status  Information. 
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2.3.5.1.55  aniino_weapon_removed 

This  routine  removes  the  selected  ammo  from  the  appropriate  ammo  box  and  loads  the 
weapon. 


1  Errors  1 

Error 

Reason  for  Error 

stderr  AMMO:  ammo  weapon  removed 

Impossible  ammo  round  selected 

Calls 

Function 

Where  Described 

firecti  weapon  removed 

Section  2.3.2.2.3 

ammo  remove  hei  can  round 

Section  2.3.5.1.65 

ammo  remove  apds  can  round 

Section  2.3.5.1.64 

ammo  oet  hei  can  first  round 

Section  2.3.5.1.63 

ammo  aet  apds  can  first  round 

Section  2.3.5.1.62 

controls  missilet  flash 

Section  2.3.2 

need  to  send  veh  status 

Section  2.1.1.3.1.32.1 

controls  missile2  flash 

Section  2.3.2 

ammo  tow  test  stop 

Section  2.3.2.1.48 

Table  2.3-164:  ammo_weapon_removed  Information. 
2.3.5.1.56  ammo_weapon_is_fired 

This  routine  removes  the  selected  ammo  from  the  ammo  box,  loads  the  weapon,  fires  the 
weapon,  and  resets  the  bolt  position  to  sear. 


1  Calls  1 

Function 

Where  Described 

ammo  weapon  removed 

Section  2.3.5.1.55 

controls  bolt  position  sear 

Section  2.3.2 

Table  2.3-165:  ammo_weapon_is_fired  Information. 


2.3.5.1.57  ammo_weapon_is_misfired 

This  routine  sets  up  the  weapon  misfire  failure.  The  selected  ammo  is  removed  from  the 
ammo  box,  the  weapon  is  loaded,  and  the  bolt  position  is  set  to  misfire. 


Calls 

Function 

Where  Described 

ammo  weapon  removed 

Section  2.3.5.1.55 

controls  bolt  position  misfire 

Section  2.3.2 

Tabic  2.3-166:  ammo  weapon  is  misfired  Information. 
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2.3.5.1.58  ammo_misfire_corrected 

This  routine  repairs  the  weapon  misfire  failure  by  resetting  the  bolt  position  to  sear. 


1  Calls  1 

Function 

Where  Described 

controls  bolt  position  sear 

Section  2.3.2 

Table  2.3-167:  ammo  misfire  corrected  Information. 


2.3.5.1.59  ammo_misfire_pushed 


If  the  bolt  is  in  misfire  position  and  the  Misfire  button  is  pressed,  the  sound  of  the  misfire 
button  is  made  and  ammo  misfire  Jock  is  reset  to  FALSE. 


1  Calls  1 

Function 

Where  Described 

sound  make  const  sound 

Section  2.1. 3. 1.2 

Table  2.3-168:  ammo_misfire_pushed  Information. 


2.3.5.1.60  ammo  restore  ammo 


This  routine  resets  the  ammo  system,  filling  up  the  vehicle  with  ammo.  This  routine  is 
called  in  order  to  bypass  the  resupply  process  during  debugging. 


1  Calls  1 

Function 

Where  Described 

controls  round  select  no  round 

Section  2.3.2 

weapons.set  sinqie  shot  mode 

Section  2.3.3.2.11 

isu  round  select  not  round 

Section  2.3. 6.3.3. 6 

turret  tow  movement  off 

Section  2.3.6.1.1.29 

ammo  tow  test  stop 

Section  2.3.5.1.48 

controls  bolt  position  sear 

Section  2.3.2 

weapons  cut  any  tow  wires 

Section  2.3.3  2.9 

ammo  init  ammo  supply 

Section  2.3.5. 1.3 

Section  2.3.5.1.76 

Table  2.3-169:  ammo  restore  ammo  Information. 


2.3.5.1.61  ammo_get_missile_loaded 

This  routine  returns  munition  JUS  _TOW  if  the  loaded  status  is  TRUE,  and  EMPTY  if  the 
loaded  status  is  FALSE. 


1  Return  Values  I 

Return  Value 

Type 

Meanlna 

munition  US  TOW 

ObiectType 

A  TOW  missile  is  loaded. 

EMPTY 

ObiectType 

No  missile  is  loaded. 

Table  2.3-170:  ammo_get_missile_loaded  Information. 
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2.3.5.1.62  amino_get_apds_can_first_round 

This  routine  checks  to  see  what  type  of  ammo  is  contained  in  the  apds  ammo  box.  If  the 
box  contains  apds,  then  munition_US_M791  is  returned.  If  the  box  contains  hei,  then 
munition _US_M792  is  returned.  If  the  apds  quantity  is  equal  to  zero,  EMPTY  is  returned. 


1  Return  Values  1 

Return  Value 

Meaning 

EMPTY 

ObjectType 

There  are  no  apds  canisters  in 
the  vehicle. 

munition_US_M791 

ObjectType 

The  first  round  in  the  apds  box 
is  an  apds  round. 

munition_US_M792 

ObjectType 

The  first  round  in  the  apds  box 
is  an  hei  round. 

I  Calls  I 

Function 

Where  Described 

ammo  get  apds  can  box 

Section 

Table  2.3-171:  aTnmo_get_apds_can_first_round  Information. 
2.3.5.1.63  ammo_get_hei_can_fi rst_round 


This  routine  checks  to  see  what  type  of  ammo  is  contained  in  the  hei  ammo  box.  If  the  box 
contains  apds,  then  munitionJUS_M791  is  returned.  If  the  box  contains  hei,  then 
munition JJS_M792  is  returned.  If  the  hei  quantity  is  equal  to  zero,  EMPTY  is  returned. 


I  Return  Values  I 

Return  Value 

Type 

Meaning 

EMPTY 

ObjectType 

There  are  no  hei  canisters  in 
the  vehicle. 

munition_US_M791 

ObjectType 

The  first  round  in  the  hei  box  is 
an  apds  round. 

munition_US_M792 

ObjectType 

The  first  round  in  the  hei  box  is 
an  hei  round. 

Calls 

Function 

Where  Described 

ammo  get  hei  can  box 

Section  2.3.5.1.67 

Table  2.3-172:  ammo_get_hei_can_first_round  Information. 
2.3.5.1.64  ammo_remove_apds_can_round 

This  routine  decrements  the  quantity  of  apds  canisters  in  the  vehicle.  If  the  quantity  of  apds 
canisters  is  zero,  the  routine  does  nothing. 


I  Calls  I 

Function 

Where  Described 

need  to  send  veh  status 

Section  2.1.1.3.1.32.1 

Table  2.3-173:  ammo  remove  apds  can  round  Information. 


2.3.5.1.65  ammo  remove  hei  can  round 
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This  routine  decrements  the  quantity  of  hei  canisters  in  the  vehicle.  If  the  quantity  of  hei 
canisters  is  zero,  the  routine  does  nothing. 


1  Calls  1 

Function 

Where  Described 

need  to  send  veh  status 

Section  2.1.1.3.1.32.1 

Table  2.3-174:  amino_remove_hei_can_round  Information. 
2.3.5.1.66  ammo_get_apds_can_box 

This  routine  performs  an  existence  check  on  the  ammo  box  passed  in  boxjium. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

box  num 

int 

Standard 

I  Return  Values  I 

Return  Value 

Meanina 

(apds_can_ammo_boxes  » 
box  num)  &  0x1 

char 

The  munition  type  in  the 
ammo  box. 

Table  2.3-175;  ammo_get_apds_can_box  Information. 
2.3.5.1.67  ammo_get_hei_can_box 

This  routine  performs  an  existence  check  on  the  ammo  box  passed  in  boxjium. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

box  num 

int 

Standard 

1  Return  Values  1 

Return  Value 

Meanina 

(heLcan_ammo_boxes  » 
box.  num)  &  0x1 

char 

The  munition  type  in  the 
ammo  box. 

Table  2.3-176:  ammo_get_hei_can_box  Information. 
2.3.5.1.68  ammo_print_ammo_variabIes 
This  routine  prints  the  different  ammunition  quantities  for  debugging. 
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2. 3. 5,.  1.69  ammo_ready_to_internal_resupply 

This  rcaatine  sets  up  the  ammo  system  for  an  internal  resupply.  The  turret  must  be  in  the 
appropriate  load  position,  the  Turret  Travel  Lock  Switch  must  be  LOCKED,  the  Turret 
Drive  Sssytem  Switch  must  be  OFF,  and  the  Internal  pushbutton  on  the  Ammunition 
Management  Panel  must  be  pressed.  If  any  of  these  conditions  are  not  met,  the  routine 
letums-  FALSE.  The  routine  checks  that  there  is  room  in  the  appropriate  ammo  box  or 
missile  ^be,  and  that  there  is  enough  supply  in  stowage  for  the  transfer.  If  so,  the  routine 
(retumsTRUE.  If  not,  the  routine  returns  FALSE. 


1  Return  Values  I 

.©eturn  Value 

Type 

Meaning 

FALSE 

int 

The  system  is  not  ready  for  an 
internal  transfer. 

.ammo_kiei_can_enough_ 
foomO  &&  ammo_hei_ 
?stowagis_enough_supply() 

int 

If  TRUE,  the  system  is  ready 
for  an  internal  transfer:  there 
is  room  in  the  hei  ammo  box 
and  sufficient  hei  in 
stowage; 

If  FALSE,  the  system  is  not 
ready  for  an  internal  transfer 

ammo_aipds_can_enough_ 
■fOomO  &&  ammo_hei_ 
!Stowage_enough_supply() 

int 

If  TRUE,  the  system  is  ready 
for  an  internal  transfer:  there 
is  room  in  the  apds  ammo 
box  and  sufficient  hei  in 
stowage; 

If  FALSE,  the  system  is  not 
ready  for  an  internal  transfer 

ammoJneLcan_enough_ 
room()  &&  ammo_apds_ 
stowagT£-_enough_supply() 

int 

If  TRUE,  the  system  is  ready 
for  an  internal  transfer:  there 
is  room  in  the  hei  ammo  box 
and  sufficient  apds  in 
stowage; 

If  FALSE,  the  system  is  not 
ready  for  an  internal  transfer 

ammo_apds_can_enough_ 
room()  &&  ammo_apds_ 
stowagf$_enough_supply() 

int 

If  TRUE,  the  system  is  ready 
for  an  internal  transfer:  there 
is  room  in  the  apds  ammo 
box  and  sufficient  apds  in 
stowage; 

If  FALSE,  the  system  is  not 
ready  for  an  internal  transfer 

ammo_bDw_tubes_enough_ 
room()  &&  amnio_tow_ 
stow^e_enough_supply() 

int 

If  TRUE,  the  system  is  ready 
for  an  internal  transfer;  there 
is  room  in  the  missile  tubes 
and  sufficient  TOW  missiles 
in  stowage; 

If  FALSE,  the  system  is  not 
ready  for  an  internal  transfer 
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Calls 

Function 

Where  Described 

controls  turret  drive  system  status 

Section  2.3.2 

alpha  aet  load 

Section  2.3. 2.3.1 

ammo  hei  can  enouah  room 

Section  2.3.5.1.77 

ammo  hei  stowage  enough  supply 

Section  2.3.5.1.83 

ammo  apds  can  enough  room 

Section  2.3.5.1.78 

ammo  apds  stowage  enough  supply 

Section  2.3.5.1.84 

ammo  tow  tubes  enough  room 

Section  2.3.5.1.80 

ammo  tow  stowage  enough  supply 

Section  2.3.5.1.85 

launcher  get  val 

Section  2.3.6.1.4.6 

Table  2.3-177:  ammo_ready_to_internal_resuppIy  Information. 
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2.3.5.1.70  ammo_ready_to_externaI_resupply 

This  routine  sets  up  the  ammo  system  for  an  external  resupply.  The  tunet  must  be  in  the 
appropriate  load  position,  the  Turret  Travel  Lock  Switch  must  be  LOCKED,  the  Turret 
Drive  Ssytem  Switch  must  be  OFF,  and  the  Receive  pushbutton  on  the  Ammunition 
Management  Panel  must  be  pressed.  If  any  of  these  conditions  are  not  met,  the  routine 
returns  FALSE.  The  routine  checks  that  there  is  room  in  either  the  appropriate  ammo  box, 
missile  tube,  or  stowage  for  the  receipt  of  ammo.  If  so,  the  routine  returns  TRUE.  If  not, 
the  routine  returns  FALSE. 


I  Return  Values  1 

Return  Value 

Type 

Meaning 

FALSE 

int 

The  system  is  not  ready  for  an 
external  resupply. 

ammo_heLcan_enough_ 
fDomO  1 1  ammo_25mm_ 
stowage_enough_room() 

int 

If  TRUE,  the  system  is  ready 
for  an  external  resupply: 
there  is  either  room  in  the 
ammo  box  or  in  stowage  for 
hei; 

If  FALSE,  the  system  is  not 
ready  for  an  external 
resupply. 

ammo_apds_can_enough_ 
roomO  1 1  amm_25mm_ 
stowage_enough_room() 

int 

If  TRUE,  the  system  is  ready 
for  an  external  resupply: 
there  is  either  room  in  the 
ammo  box  or  in  stowage  for 
apds; 

If  FALSE,  the  system  is  not 
ready  for  an  external 
resupply. 

ammo_25mm_stowage_ 

enough_room() 

int 

If  TRUE,  the  system  is  ready 
for  an  external  resupply: 
there  is  room  in  stowage: 
if  FALSE,  the  system  is  not 
ready  for  an  external 
resupply. 

ammo_tow_tubes_enough_ 
room()  1 1  ammo_tow_ 
stowage_enough_room() 

int 

If  TRUE,  the  system  is  ready 
for  an  external  resupply: 
there  is  either  room  in  the 
missile  tubes  or  in  stowage 
for  TOW  missiles; 

If  FALSE,  the  system  is  not 
ready  for  an  external 
resupply. 

ammo_tow_stowage_ 

enough_room() 

int 

If  TRUE,  the  system  is  ready 
for  an  external  resupply: 
there  is  room  in  stowage: 

If  FALSE,  the  system  is  not 
ready  for  an  external 
resupply. 
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ammo_dragon_stowage_ 

enough_room() 

int 

If  TRUE,  the  system  is  ready 
for  an  external  resupply: 
there  is  room  in  stowage  for 
dragon  missiles; 

If  FALSE,  the  system  is  not 
ready  for  an  external 
resupply. 

Calls 

Function 

Where  Described 

controls  turret  drive  system  status 

Section  2.3.2 

alpha  qet  load 

Section  2.3. 2.3.1 

ammo  hel  can  enough  room 

Section  2.3.5.1.77 

ammo  25mm  stowage  enough  room 

Section  2.3.5.1.79 

ammo  apds  can  enough  room 

Section  2.3.5.1.78 

ammo  tow  tubes  enough  room 

Section  2.3.5.1.80 

ammo  tow  stowage  enough  room 

Section  2.3.5.1.81 

ammo  dragon  stowage  enough  room 

Section  2.3.5.1.82 

Table  2.3-178:  amino_ready_to_external_resupply  Information. 
2.3.5.1.71  ammo_ready_to_external_send 

This  routine  sets  up  the  ammo  system  for  an  external  ammo  send.  If  the  Send  pushbutton 
on  the  Ammunition  Management  Panel  is  pressed,  the  turret  drive  system  is  on,  and  there  is 
sufficient  ammo  in  stowage  to  transfer,  the  routine  returns  TRUE.  If  any  of  these 
conditions  are  not  met,  the  routine  returns  FALSE. 


1  Return  Values  I 

Return  Value 

Meaning 

(ammo  transfer  status  == 
AMMO_SEND_VAL)  && 

(1  controls_turret_drive_ 
system_status())  && 

(!  ammo_supply_empty_ 
stowageO) 

int 

If  TRUE,  the  vehicle  is  ready 
for  an  external  send. 

If  FALSE,  the  vehicle  is  not 
ready  for  an  external  send. 

1  Calls  1 

Function 

Where  Described 

controls  turret  drive  system  status 

Section  2.3.2 

ammo  supply  empty  stowage 

Section  2.3.5.1.72 

ammo_ready_to_externaI_send  Information. 


Table  2.3-179: 
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* 


2.3.5.1.72  ammo_suppI y_empty_stowa ge 

This  routine  no  ammunition  is  left  in  stowage,  this  routine  returns  TRUE. 


1  Return  Values  1 

Return  Value 

Meaning 

TRUE 

int 

There  is  no  ammo  in  stowage. 

FALSE 

int 

There  is  ammo  in  stowage. 

Table  2.3-180:  ammo_supply_empty_stowage  Information. 
2.3.5.1.73  ammo_start_internal_resupply 

This  routine  starts  the  internal  resupply.  The  routine  notifies  the  controls  to  flash  the 
selected  ammo  pushbutton  lamp  for  the  amount  of  time  in  either  the  DELAY_25MM 
constant  or  the  DELAY_MISSILE  constant,  depending  upon  which  type  of  ammo  is 
selected.  The  internal _resupplyjn _progress  variable  i..  set  to  TRUE. 


1  Calls  1 

Function 

Where  Described 

controls  internal  flash 

Section  2.3.2 

controls  hei  flash 

Section  2.3.2 

controls  agds  flash 

Section  2.3.2 

controls  tow  flash 

Section  2.3.2 

Table  2.3-181:  ^mmo_start_internaI_resuppIy  Information. 
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2.3.5.1.74 


ammo_start_external_resupply 


This  routine  starts  the  external  resupply.  apds25,  hei25,  tow,  and  dragon  are  the  quantities 
of  specific  ammo  types  available  for  transfer  from  the  sending  vehicle. 


The  routine  notifies  the  controls  to  flash  both  the  Receive  pushbutton  lamp  and  the  selected 
ammo  pushbutton  lamp  for  the  amount  of  time  in  either  the  DELAY_25\^  constant  or  the 
DELAY_MISSILE  constant.  If  the  external  resupply  was  successfully  started,  the  routine 
returns  TRUE.  If  no  ammunition  of  the  desired  type  is  available  from  the  sending  vehicle, 
the  routine  returns  FALSE. 


1  Parameters  I 

1  Parameter  1 

Where  Tvpedef  Declared 

int 

Standard 

hei25 

int 

Standard 

tow 

int 

Standard 

draqon 

int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaninq 

TRUE 

int 

Resupply  of  the  selected 
ammo  has  started. 

FALSE 

int 

Resupply  of  the  selected 
ammo  is  not  possible. 

1  Calls 

Function 

Where  Described 

controls  receive  flash 

Section  2.3.2 

controls  hei  flash 

Section  2.3.2 

controls  apds  flash 

Section  2.3.2 

controls  tow  flash 

Section  2.3.2 

controls  draqon  flash 

Section  2.3.2 

Table  2.3-182;  ammo_start_externaI_resuppIy  Information. 
2.3.5.1.75  ammo_start_external_send 

This  routine  starts  the  external  send.  Controls  are  notified  to  flash  the  Send  indicator. 


1  Calls  1 

Function 

Where  Described 

controls  send  flash 

Section  2.3.2 

Table  2.3-183:  ammo  start  external  send  Information. 
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2.3.5.1.76  ammo_stop_resupply 

This  routine  stops  a  resupply,  resetting  all  indicators. 


1  Calls  1 

Function 

Where  Described 

resupplv  stop  ammo  resupply 

Section  2.3.5.3.30 

controls  receive  on 

Section  2.3.2 

controls  send  off 

Section  2.3.2 

controls  internal  off 

Section  2.3.2 

controls  hei  on 

Section  2.3.2 

controls  hei  off 

Section  2.3.2 

controls  apds  on 

Section  2.3.2 

controls  apds  off 

Section  2.3.2 

controls  tow  on 

Section  2.3.2 

controls  tow  off 

Section  2.3.2 

controls  draqon  on 

Section  2.3.2 

controls  draqon.off 

Section  2.3.2 

Table  2.3-184:  ammo_stop_resuppIy  Information. 
2 . 3 . 5 . 1..  7  7  ammo_hei_can_enough_room 
This  routine  determines  if  there  is  room  for  more  hei  ammo  in  the  vehicle. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

TRUE 

int 

There  is  room  for  more  hei  in 
the  vehicle. 

FALSE 

int 

There  is  no  more  room  for  hei 
in  the  vehicle. 

Table  2.3-185:  ammo_hei_can_enough_room  Information. 
2.3.5.1.78  ammo_apds_can_enough_room 
This  routine  determines  if  there  is  room  for  more  apds  ammo  in  the  vehicle. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

TRUE 

int 

There  is  room  for  more  apds  in 
the  vehicle. 

FALSE 

int 

There  is  no  more  room  for 
apds  in  the  vehicle. 

Table  2.3-186:  ammo_apds_can_enough_room  Information. 
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2.3.5.1.79  ammo_25mm_stowage_enough_room 

This  routine  determines  if  there  is  room  for  more  25mm  ammo  (either  hei  or  apds)  in 
stowage. 


1  Return  Values  1 

Return  Value 

Type 

Meanina 

TRUE 

int 

There  is  room  for  more  25mm 
ammo  in  stowaae. 

FALSE 

int 

There  is  no  more  room  for 
25mm  ammo  in  stowaae. 

Table  2.3-187:  ammo_25mm_stowage_enough_room  Information. 
2.3.5.1.80  ammo_tow_tu bes_enough_room 

This  routine  determines  if  there  is  room  for  more  missiles  in  the  TOW  missile  tubes. 


I  Return  Values  1 

Return  Value 

Type 

jEmsMwmmmmm 

TRUE 

int 

There  is  room  for  more 
missiles  in  the  missile  tubes. 

FALSE 

int 

Both  missile  tubes  are  full. 

Table  2.3-188:  ammo_tow_tubes_enough_room  Information. 


2.3.5.1.81 


ammo_tow_stowage_enough_room 


This  routine  determines  if  there  is  room  for  more  TOW  missiles  in  stowage. 


1  Return  Values  1 

Return  Value 

Type 

Meanina 

TRUE 

int 

There  is  room  for  more  TOW 
missiles  in  stowage. 

FALSE 

int 

There  is  no  room  for  more 

TOW  missiles  in  stowage. 

Table  2.3-189:  ammo_tow_stowage_enough_room  Information. 
2.3.5.1.82  ammo_dragon_stowage_enough_room 
This  routine  determines  if  there  is  room  for  more  dragon  missiles  in  stowage. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

TRUE 

int 

There  is  room  for  more  dragon 
missiles  in  stowage. 

FALSE 

int 

There  is  no  room  for  more 
dragon  missiles  in  stowage. 

Table  2.3-190:  ammo_dragon_stowage_enough_room  Information. 

» 


791 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


2.3.5.1.83  ammo_hei_stowage_enough_suppIy 

This  routine  determines  if  there  is  a  sufficient  supply  of  hei  ammo  in  stowage. 


1  Return  Values  1 

Return  Value 

Type 

Meanina 

TRUE 

int 

There  is  a  sufficient  supply  of 
hei. 

FALSE 

int 

There  is  not  a  sufficient  supply 
of  hei. 

Table  2.3-191;  ammo_hei_hei_stowage_suppIy  Information. 
2.3.5.1.84  ammo_apds_stowage_enough_supply 

This  routine  determines  if  there  is  a  sufficient  supply  of  apds  ammo  in  stowage. 


1  Return  Values  I 

Return  Value 

Meanina 

TRUE 

int 

There  is  a  suff  icient  supply  of 
apds. 

FALSE 

int 

There  is  not  a  sufficient  supply 
of  apds. 

Table  2.3-192:  ammo_apds_stowage_enough_supply  Information. 
2.3.5.1.85  ammo_tow_stowage_enough_supply 


This  routine  determines  if  there  is  a  sufficient  supply  of  TOW  missiles  in  stowage. 


1  Return  Values  1 

Return  Value 

Type 

Meanina 

TRUE 

int 

There  is  at  least  one  TOW 
missile  in  stowage. 

FALSE 

int 

There  are  no  TOW  missiles  in 
stowage. 

Table  2.3-193:  ammo_tow_stowage_enough_supply  Information. 
2.3.5.1.86  ammo_turret_no_power_off 

This  routine  stops  any  internal  resupply  in  progress,  sets  the  management  round  to  empty, 
and  resets  the  resupply  counter  to  zero. 
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2.3.5.1.87  amino_internaI_resupply_start_check 

On  a  tick  by  tick  basis,  tins  routine  is  called  to  see  if  the  conditions  for  starting  an  internal 
resupply  are  met.  In  order  to  perform  an  internal  resupply,  the  following  conditions  must 
be  met:  the  resupply  counter  is  set  at  zero,  no  internal  transfer  is  cuirently  in  progress,  the 
Internal  pushbutton  has  been  pressed,  a  valid  round  has  been  selected  for  transfer,  and  the 
resupply  gating  conditions  have  been  met.  If  the  conditions  are  met,  the  internal  resupply 
is  start^. 


1  Calls  1 

1  Function 

Where  Described 

1 11‘g  1  III  1  ■  1 1 1  III!  1 1  — 

Section  2.3.5.3.15 

ammo  ready  to  internal  resupply 

Section  2.3.5.1.69 

ammo  start  Internal  resupply 

Section  2.3.5.1.73 

Table  2.3-194:  ammo_internaI_resupply_start_check  Information. 
2.3.5.1.88  ammo_internal_resuppIy_abort_check 

On  a  tick  by  tick  basis,  this  routine  is  called  to  see  if  any  of  the  resupply  abort  conditions 
have  been  met.  An  internal  resupply  which  was  in  progress  is  aborted  if  either  the  resupply 
gating  conditions  are  no  longer  met  or  the  ammo_ready_to_internaI_resuppIy  routine 
returns  FALSE. 


1  Calls  1 

1  Function 

Where  Described 

Section  2.3.5.3.15 

lammo  ready  to  internal  resupply 

Section  2.3.5.1.69 

Section  2.3.5.1.76 

Table  2.3-195:  ammo_internal_resupply_abort_check  Information. 
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2.3.5.1.89  ammo_resuppIy_timeout_check 

This  routine  is  called  on  a  tick  by  tick  basis  to  check  for  an  ammo  resupply  timeout 

For  ail  external  resupply,  the  routine  checks  to  see  if  the  selected  ammo  type  was  received. 
If  so,  the  inventory  quantities  for  that  type  of  ammo  are  adjusted  and  a  veWcle  status 
message  is  sent. 

The  routine  does  nothing  in  the  case  of  an  external  send. 

For  an  internal  resupply,  the  routine  adjusts  the  inventory  quantities  for  the  new  ammo 
locations  and  sends  a  vehicle  status  message. 


1  Calls  1 

Function 

Where  Described 

controls  hei  on 

Section  2.3.2 

controls  receive  on 

Section  2.3.2 

resupply  ammo  received 

Section  2.3.5.3.10 

aipha  pet  load 

Section  2.3.2.3.1 

ammo  hei  can  enouah  room 

Section  2.3.5.1.77 

need  to  send  veh  status 

Section  2.1.1.3.1.32.1 

ammo  apds  can  enouah  room 

Section  2.3.5.1.78 

controls  apds  on 

Section  2.3.2 

controls  tow  on 

Section  2.3.2 

controls  missilet  on 

Section  2.3.2 

controls  missile2  on 

Section  2.3.2 

controls  draqon  on 

Section  2.3.2 

controls  internal  on 

Section  2.3.2 

Table  2.3-196:  ammo_internaI_resuppIy_start_check  Information. 


2.3.5.1.90  ammo  rounds  on  board  check 


On  a  tick  by  tick  basis,  this  routine  is  called  to  update  the  Rounds  on  Board  counter  for 
each  ammo  type. 


1  Calls  1 

Function 

Where  Described 

controls  rounds  on  board 

Section  2.3.2 

controls  blank  rounds  on  board 

Section  2.3.2 

Table  2.3-197: 


ammo  rounds  on  board  check  Information. 
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2.3.5.1.91  ammo_resupply_sent 

This  routine  stops  the  external  send  and  recalculates  the  stowage  inventory  for  the  type  of 
ammo  sent,  ammo  jype  is  the  ammunition  type  that  was  sent. 


1  Calls  1 

Function 

Where  Described 

need  to  send  veh  status 

Section  2.1.1.3.1.32.1 

Section  2.3.5.1.76 

Table  2.3-198:  ammo  rounds  on  board  check  Information. 


2.3.5.1.92  ammo_decide_round_type 
This  routine  returns  the  selected  round. 


1  Return  Values  1 

Return  Value 

Meaning 

ammo  mamt  round 

ObiectType 

The  selected  round. 

Table  2.3-199:  ammo_declde_round_type  Information. 
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2. 3. 5. 2  in2_fuelsys.c 

(./simnet/release/src/vehicle/m2/src/m2_fuelsys.c  [m2_fuelsys.c]) 

T’ie  M2’s  fuel  supply  is  monitored  by  this  CSU.  The  M2  uses  diesel  fuel  which  is  stored 
in  two  separate  but  interconnected  fuel  tanks.  The  top  tank  has  approximately  a  30  gallon 
capacity  and  the  lower  tank  has  approximately  a  145  gallon  capacity,  for  a  to^  capacity  of 
175  gallons.  The  engine  runs  off  the  upper  t^  while  the  fuel  gauge  indicates  the  quantity 
in  the  lower  tank.  The  fuel  control  handle  starts  and  stops  fuel  flow  to  the  engine.  If  the 
engine  accessory  is  off,  fuel  is  not  transferred  from  the  bottom  tank  to  the  top  tank,  thus, 
the  engine  can  only  use  as  much  fuel  as  is  held  by  the  top  tank.  The  fuel  low  light  is  not 
modeled.  Variables  for  resupply:  30  gallons  per  minute  times  1  min/60  sec  times  1  sec/15 
frames  =  0.0333333333333333  gallons  per  frame. 

This  file  includes: 

"stdio.h" 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 

"libfail.h" 

"failure.h" 

"m3_fuelsys.h" 

"m2_fuel_df.h" 

"m2_meter.h" 

"timers.h" 

"timers_dfn.h" 

"m2_resupp.h’’ 

"m2_sound.h" 


Declarations: 

fuel_xfer_fuel() 

fuel3op_tank_not_einpty() 

fuel_resupply_tank() 

fuelsys_status 

fueLflow 

top_fuel_level 

bottom_fuel_level 

engine_accessory 

resupply_timerjd 

tank_being_resupplied 

total_resupplied 

resupply_status 

mcc_offering 

rVfcfinpQ* 

RESUPPLYJNTERVAL 

RESUPPLY  RATI- 
FUEL_  PER  INTERVAL 


The  status  of  the  fuel  button 


The  timer  id  for  resupply 
The  tank  which  is  receiving  fuel 
The  fuel  taken  in  a  resupply  interval 
If  TRUE,  a  resupply  is  in  progress 
The  amount  of  fuel  offered  by  the  MCC 


Interval  (seconds)  before  sending  replv  to  the 
MCC 

GPM  of  fuel  transfer  from  truck 
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2. 3. 5. 2.1  fuel_init_tanks 

This  routine  is  used  by  the  MCC  to  intitialize  the  fuel  level  in  each  tank.  This  routine 
should  be  called  before  fuel_init(). 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

top 

REAL 

sim  types. h 

bottom 

REAL 

Sim.  types. h 

Table  2.3-200:  fuel_init_tanks  Information. 

2. 3. 5. 2. 2  fuel_init 

This  routine  initializes  the  fuel  system.  The  resupply  status  variables  and  failures  are 
initialized. 


1  Calls  1 

Function 

Where  Described 

fail  init  failure 

Section  2.5.4.11.2 

Table  2.3-201:  fuel  init  Information. 

2. 3. 5. 2. 3  fuel_simul 

This  routine  simulates  the  various  functions  of  the  fuel  system  on  a  tick  by  tick  basis. 
These  functions  consist  of:  1)  monitoring  the  fuel  levels  in  each  tank,  2)  transferring  fuel 
between  the  top  and  bottom  tanks,  3)  resupplying  fuel,  4)  stopping  the  fuel  resupply,  and 
5)  setting  the  meter  amount  of  fuel  in  the  bottom  tank.  Note  that  fuel  may  be  transferred 
between  the  top  and  bottom  tanks  when  the  engine  accessory  is  on  and  the  engine  is 
running. 


1  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

fuel  usage  this  tick 

REAL 

Sim  types. h 

1  Calls  1 

Function 

Where  Described 

engine  running 

Section  2.3.6.2.5.10 

electsys  fuel  xfer  pump  reguest 

Section  2.3.6.3.1.25 

fuel  .xfer_  fuel 

Section  2.3.5. 2.6 

fuel  .resupply  tank 

Section  2.3.5.2.15 

timers  get  ticking  status 

Section  2.6.3.20.1 

fuel  stop  resupply 

Section  2.3.5.2.14 

meter  fuel  set 

Section  2.3. 2.3.3 

Table  2.3-202:  fuel  simul  Information. 
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2. 3. 5. 2. 4  fueI_top_tank_not_einpty 

This  routine  returns  TRUE  if  the  top  fuel  tank  is  not  empty  and  FALSE  if  the  top  fuel  tank 
is  empty. 


1  Return  Values  1 

Return  Value 

Meanina 

topjueljevel  >  0.0 

BOOLEAN 

If  TRUE,  the  top  fuel  tank  is 
not  empty; 

if  FALSE,  the  top  fuel  tank  is 
empty 

Table  2.3*203:  fueI_top_tank_not_empty  Information. 
2. 3. 5. 2. 5  fuel_set_fIow 

This  routine  sets  the  fuel Jlow  variable  equal  to  the  parameter  value. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

value 

REAL 

Sim  tvpes.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

FALSE 

BOOLEAN 

Either  the  fuel  button  is  OFF, 
the  top  fuel  tank  is  empty,  or 
an  error  has  occurred 

fuelsys_status  && 
fuelJop_tank_not_empty() 

BOOLEAN 

If  TRUE,  then  the  fuel  button 
is  ON,  the  top  fuel  tank  is  not 
empty,  and  the  fueljlow 
variable  is  set  to  vaiue\ 

If  FALSE,  then  either  the  fuel 
button  is  OFF  or  the  top  fuel 
tank  is  empty 

1  Errors  I 

Error 

Reason  for  Error 

PANIC 

negative  fuel  flow  rate 

1  Calls  1 

Function 

Where  Described 

fuel  top  tank  not  empty 

Section  2.3.5. 2.4 

Table  2.3-204:  fuel_set_flow  Information. 

2. 3. 5. 2. 6  fuel_xfer_fuel 

This  routine  calculates  the  top  and  bottom  fuel  tank  levels  after  a  fuel  transfer  between 
tanks. 
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2. 3. 5. 2. 7  fuel_engine_accessory_oii 

This  routine  is  called  by  the  controls  software  to  let  the  fuel  system  know  that  the  engine 
accessory  has  been  turned  on. 


1  Calls  1 

Function 

Where  Described 

sound  of  enaine  accessory  on 

Section  2.1.3.3.25 

Table  2.3-205:  fuel_engine_accessory_on  Information. 

2 . 3 . 5 . 2 . 8  fueI_engine_accessory_off 

This  routine  is  called  by  the  controls  software  to  let  the  fuel  system  know  that  the  engine 
accessory  has  been  turned  off.  When  the  engine  accessory  is  turned  off,  fuel  can  no  longer 
be  transferred. 


1  Calls  1 

Function 

Where  Described 

sound  of  enqine  accessory  off 

Section  2.1.3.3.27 

Table  2.3-206:  fuel_engine_accessory_off  Information. 
2. 3. 5. 2. 9  fueMevel_bottom 

This  routine  returns  the  fuel  level  of  the  bottom  fuel  tank. 


1  Return  Values  1 

Return  Value 

Meaning 

bottomjueljevel 

REAL 

the  level  in  the  bottom  fuel 
tank 

Table  2.3-207:  fuel_level_bottom  Information. 
2.3.5.2.10  fuel_level_top 

This  routine  returns  the  fuel  level  of  the  top  fuel  tank. 


1  Return  Values  I 

Return  Value 

top  fuel  level 

REAL 

the  level  in  the  top  fuel  tank  I 

Table  2.3-208:  fuel_level_top  Information. 
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2.3.5.2.11  fuel_supply_full 


This  routine  calculates  whether  the  amount  of  fuel  in  the  parameter  delta  will  fill  the  fuel 
tanks. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

delta 

REAL 

Sim  types. h 

1  Return  Values  I 

Return  Value 

Type 

TRUE 

BOOLEAN 

delta  will  fill  the  fuel  supply 

FALSE 

BOOLEAN 

delta  will  not  fill  the  fuel  supply 

Table  2.3-209:  fuel_supply_full  Information. 

2.3.5.2.12  fuel_decide_resupply_quantity 

This  routine  calculates  the  amount  of  fuel  needed  to  fill  both  tanks  and  returns  either  the 
maximum  quanity  of  fuel  allowed  to  transfer  in  one  resupply  interval  or  the  actual  amount 
of  fuel  necessary  to  fill  both  tanks  (whichever  is  lower). 


1  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

fuel  needed 

REAL 

Sim  types. h 

1  Return  Values  I 

Return  Value 

Meaning 

(int)  min(fuel  needed, 

FUEL  PER  INTERVAL) 

int 

the  quantity  of  fuel  necessary 
for  resupply 

Table  2.3-210:  fuel_decide_resupply_quantity  Information. 
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2.3.5.2.13  fuel_start_external_resupply 

This  routine  starts  the  external  resupply  of  fuel  process.  If  the  amount  of  fuel  the  MCC  is 
offering  is  less  than  0  gallons,  the  routine  returns  FALSE.  Otherwise,  the  routine  starts  the 
resupply  timer,  determines  which  tanks  should  be  resupplied,  and  returns  TRUE. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

fuel  offered 

int 

Standard 

1  Return  Values  1 

Return  Value 

Meaning 

TRUE 

BOOLEAN 

the  external  resupply  was 
started 

FALSE 

BOOLEAN 

the  external  resupply  was  not 
started 

1  Calls  1 

Function 

Where  Described 

timers  qet  timers 

Section  2. 6.3.6. 1 

Table  2.3-211:  fuel_start_external_resupply  Information. 
2.3.5.2.14  fuel_stop_resupply 

This  routine  stops  the  fuel  resupply.  The  timers  are  freed,  the  resupply  status  is  set  to 
OFF,  and  the  amount  of  fuel  received  during  the  resupply  is  calculated. 


1  Calls  1 

Function 

Where  Described 

timers  free  timers 

Section  2.6.3.5.1 

resupply  fuel  received 

Section  2.3.5.3.11 

Table  2.3-212:  fuel_stop_resuppIy  Information. 
2.3.5.2.15  fuel_resupply_tank 

This  routine  calculates  the  amount  of  fuel  in  each  tank  after  a  fuel  resupply. 


1  Errors  1 

Error 

Reason  for  Error 

stderr 

WARNING;  invalid  tank  selection  for  resupply 

Table  2.3-213:  fuel_resupply_tank  Information. 

2.3.5.2.16  print_fuel_variables 

This  routine  prints  the  fuel  variables:  top  Juel  level,  bottom  J'uel  level,  engine _accessory, 
and  fuelsys_status. 
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2.3.5.2.17  fueI_on 

This  routine  sets  the  fuelsys  status  flag  to  ON. 

2.3.5.2.18  fueI_off 

This  routine  sets  the  fuelsys  status  flag  to  OFF. 

2.3.5.2.19  fuel_transfer_pump_failed 

This  routine  was  added  for  future  expansion. 

2.3.5.2.20  fuel_repai r_transfer_pump 

This  routine  was  added  for  future  expansion. 

2. 3. 5. 3  m2_resupp.c 

(./sirnnet/release/src/vehicle/m2/src/m2_resupp.c  [ni2_resupp.c]) 

This  CSU  coordinates  the  resupply  of  ammunition  and  fuel  to  the  M2  simulator.  The  M2 

simulator  may  also  resupply  ammunition  (but  not  fuel)  to  other  M2  simulators. 

This  file  includes: 

"stdio.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 

"mass_stdc.h" 

"dgLstdg.h" 

"sim_cig_if.h" 

"timers_dfn.h" 

"timers.h" 

"mun_type.h" 

"libnetwork.h" 

"pro_sim.h" 

"ni2_ammo_df.h" 

"m2_turr_mx.h" 

"m2_ammo.h" 

"m3_cntrl,h" 

"m2_dtrain.h" 

"m2_repair.h" 

"m2_fuel_df.h" 

"m2_launcher.h" 

"pro_assoc.h" 

"assoc.h" 


Defines: 

QUIET 

REQUEST 

LOADING 

WAITING 

SERVICING 

MAX_SERVICE  ENTlTll'S 
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Declarations: 

ammo_caiTier 

fueLcarrier 

ammo_receiver 

num_ainino_carriers 

num_fuel_caniers 

num_animo_receivers 

ammo_carriers_near_here 

fuel_carTiers_near_here 

ainmo_receivers_near_here 

ainmo_resupply_receive_state 

ammo_has_been_received 

ammo_that_was_received 

ainmo_rcceive_timer_id 

ammo_carrier_id 

fuel_rcsupply_receive_stae 

fuel_has_been_received 

fuel_that_was_received 

fuel_rcceive_timer_id 

fuel_carrier_id 

ammo_resupply_send_state 

ammo_send_timer_id 

ammo_receiver_id 

cIear_amino_carriers() 

clear“fuel_carriers() 

cIear~amino_receivers() 

sendjreed_nre_packets_ammo_carriers() 

send~feed~me_packets~fuel_carriers() 

ainino_r€ceive~quiet_state()~ 

fuel_receive_quiet_state() 

ammo  send  quiet_state() 

ammo_receive_request_state() 

fuel_receive_request_sFate() 

ammo_send  waiting_state() 

ammo~recefve_loading_state() 

fuel_receive_Ioading_state() 

aniino_send3ervicing_state() 

ammo_resuppIy_receive  simulO 

fuel_resupply_receive_srmul() 

aiiiino_resupply_send3iniul() 

vehicle_is_close() 

2. 3. 5. 3.1  clear_ammo_carriers 

This  routine  clears  the  ammo  carriers  near  Jtere  flag  to  FALSE  and  the  number  of  ammo 

carriers  to  zero. 
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:2.3.5.3.2  clear_fuel_carriers 

'This  routine  clears  the  fuel _carriers  near  here  flag  to  FALSE  and  the  number  of  fuel 
icarriers  to  zero. 

'^.3. 5. 3. 3  cIear_ammo_receivers 

TThis  routine  clears  the  ammo  carriers  near  here  flag  to  FALSE  and  the  number  of  ammo 
Deceivers  to  zero. 

'2. 3. 5. 3. 4  print_resupply_status 

'This  routine  prints  the  resupply  status  information. 

. 3 .5 . 3 . 5  sen  d_feed_me_packets_ammo_ca  triers 

'lOiis  routine  sends  a  service  request  packet  to  each  of  the  ammo  carriers  on  the  network, 
ixequesting  the  specific  types  of  ammunition  necessary  for  resupply. 


1  Internal  Variables  I 

V'arlable 

Type 

Where  Typedef  Declared 

i 

int 

Standard 

rmunition 

basic.h 

1  Calls  1 

Function 

Where  Described 

aimmo  decide  round  type 

Section  2.3.5.1.92 

network  send  feed  me  packet 

Section  2.1.1.3.1.48.1 

Table  2.3*214:  send_feed_me_packets_ammo_carriers  Information. 


iZ .  3 . 5 . 3 , 6  send_feed_me_packets_fuel_car  tiers 

'This  routine  sends  a  service  request  packet  to  each  of  the  fuel  carriers  on  the  network, 
irequesting  a  specific  quantity  of  fuel  necessary  for  resupply. 


1  Internal  Variables  1 

Warlable 

Where  Typedef  Declared 

ii 

int 

Standard 

munition 

MunitionQuantity 

basic.h 

1  Calls  1 

frunction 

Where  Described 

tiuel  decide  resupply  quantity 

Section  2.3.5.2.12 

.network  send  feed  me  packet 

Section  2.1.1.3.1.48.1 

Table  2.3-215  send_feed_me_packels_fuel_carriers  Information. 
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2 . 3 . 5 . 3 . 7  resuppIy_near_ammo_carrier 

This  routine  maintains  the  list  of  close  vehicles  which  are  ammo  carriers.  If  any  ammo 
carriers  are  on  this  list,  the  ammo  carriers  near  here  flag  is  set  to  TRUE. 

1  Parameters  I 

Parameter 

Where  Typedef  Declared 

V 

pointer  to  VehiclelD 

basic,  h 

Table  2.3-216: 

resuppIy_near_ammo_carrier  Information. 

2 . 3 . 5 . 3 . 8  resupply_near_fuel_carrier 

This  routine  maintains  the  list  of  close  vehicles  which  are  fuel  carriers.  If  any  fuel  carriers 
are  on  this  list,  fuel  carriers jiearjiere  flag  is  set  to  TRUE. 

1  Parameters  i 

Parameter 

Where  Typedef  Declared 

v 

pointer  to  VehiclelD 

basic.h 

Table  2.3-217: 

resupply_near_fuel_carrier  Information. 

2 . 3 . 5 . 3 . 9  resupply_near_ammo_recei  ver 

This  routine  maintains  the  list  of  close  vehicles  which  are  ammo  receivers.  If  any  ammo 
receivers  are  on  this  list,  the  ammo_receivers_near_here  flag  is  set  to  TRUE. 

1  Parameters  1 

Parameter 

Where  Typedef  Declared 

V 

pointer  to  VehiclelD 

basic.h 

Table  2.3-218:  resupply_near_ammo_receiver  Information. 
2.3.5.3.10  resupply_ammo_recei ved 

This  routine  sets  the  ammo  has  been  received  flag  to  TRUE,  and  set  the  variable 
ammojhatjvas  received  to  the  quantities  and  types  of  ammunition  that  was  received. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

ammo  type 

ObiectType 

p  sim.h 

Table  2.3-219:  resupply_ammo_received  Information. 
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2.3.5.3.11  resupply_fuel_recel  ved 

This  routine  sets  the  fuel  has  beenreceived  flag  to  TRUE,  and  set  the  variable 
fuel_that_was_received  equal  to  the  number  of  gallons  of  fuel  that  were  received. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

aallons 

int 

Standard 

Table  2.3-220:  resupply_fuel_received  Information. 
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2.3.5.3.12  resuppIy_offer_packet 

This  routine  is  called  by  the  LibRcvNet  routine  process_resuppIy_offer()  in  order  to 
process  a  message  from  a  vehicle  within  range  offering  munitions  resupply, 
resupply  offer_packet()  first  determines  the  types  and  quantities  of  munitions  carried, 
and  tiien  checks  the  ammo  and  fuel  resupply  receive  states. 

If  the  resupply  receive  state  is  QUIET,  no  munitions  have  been  requested  and  no  munitions 
are  received.  If  the  state  is  REQUEST,  the  resupply  timer  is  started  a,  the  external  resupply 
of  either  fuel  or  ammunition  (a^s25,  hei25,  or  tow)  is  started,  and  the  state  is  changed  to 
LOADING.  If  the  state  is  LOADING,  the  external  resupply  is  in  progress.  If  the  receive 
state  is  not  known,  print  an  error.  Parameters  are  represented  as  follows; 

carrier  Jd  -  The  VehiclelD  of  the  munitions  carrier. 

numjnunitions  -  The  number  of  munitions  types  carried. 
munitions  -  The  quantities  and  types  of  munitions  being  carried. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

carrier  id 

pointer  to  VehiclelD 

basic.h 

num  munitions 

usigned  char 

Standard 

munitions 

register  pointer  to 
MunitionQuantity 

basic.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

fuel 

int 

Standard 

apds25 

int 

Standard 

hei25 

int 

Standard 

tow 

int 

Standard 

dragon 

int 

Standard 

mun  type 

ObjectType 

p  sim.h 

mun  quantity 

float 

Standard 

i 

int 

Standard 

Errors 

Error 

Reason  for  Error 

RESUPPLY:  resupply_offerj3acket 

-  unkown  ammo  state 

-  unknown  fuel  state 

Calls 

Function 

Where  Described 

timers  free  timer 

Section  2.6.3.5.1 

ammo  start  external  resupply 

Section  2.3.5.1.74 

timers  get  timer 

Section  2.6.3.6.1 

Table  2.3-221:  resuppIy_offer_packet  Information. 
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2.3.5.3.13  resupply_thank_you_packet 

This  routine  is  called  by  the  LibRcvNet  routine  process_resupply_received()  in  order 
to  process  a  message  from  a  resupply  receiver  saying  that  the  ammo  was  received. 
resupply_thank _you_packetp  determines  the  types  and  quantities  of  ammo  that  were 
transfeni^,  frees  the  resupply  timer,  sets  the  resupply  send  state  to  QUIET,  and  stops  the 
ammo  resupply. 

receiver  jd  —  The  Vehicle  ID  of  the  vehicle  which  received  the  ammo  resupplies. 

numjnunitions  —  The  number  of  different  types  of  ammo  sent  by  the  carrier. 

munitions  —  The  quantity  of  each  type  of  ammo  sent  by  the  carrier. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

receiver  id 

pointer  to  VehiclelD 

basic.h 

num  munitions 

unsigned  char 

Standard 

munitions 

register  pointer  to 
MunitionQuantitv 

basic.h 

1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard 

I  Calls  1 

Function 

Where  Described 

ammo  resuDOlv  send 

Section  2.3.5.1.91 

timers  free  timers 

Section  2.6.3.6.1 

Section  2.3.5.1.76 

Table  2.3-222: 


resuppIy_thank_you_packet  Information. 
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2.3.5.3.14  resupply_feed_me_packet 

This  routine  is  called  by  the  LibRcvNet  routine  process_service_request()  in  order  to 
process  a  message  requesting  ammunition  resupply  from  a  vehicle  within  range. 
resupply_feed_me()  first  checks  the  ammo  resupply  send  state.  If  the  state  is  QUIET, 
no  supplies  are  to  be  sent.  If  the  state  is  WAITING,  send  an  offer  packet  on  the  network  to 
the  receiver  listing  the  types  and  quantities  of  munitions  that  you  have,  start  the  external 
resupply,  and  change  the  state  to  SERVICING.  If  the  state  is  SERVICING,  the  external 
resupply  is  in  progress.  If  the  state  is  not  know,  print  an  error. 

receiver  jd  —  The  VehiclelD  of  the  munitions  receiver. 

nimjnunitions  -  The  number  of  ammo  types  requested  by  the  receiver. 

feed_me_munitions  -  The  types  and  quantities  of  ammo  being  requested  by  the 

reciever. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

receiver  id 

pointer  to  VehiclelD 

basic.h 

num  munitions 

unsigned  char 

Standard 

feed  me  munitions 

pointer  to  MunitionQuantity 

basic.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

offer  munitions 

pointer  to  MunitionQuantity 

basic.h 

1  Errors  1 

Error 

Reason  tor  Error 

RESUPPLY:  resupply  feed  me  packet 

unknown  ammo 

1  Calls  1 

Function 

Where  Described 

timers  free  timers 

Section  2, 6. 3. 5.1 

timers  qet  timers 

Section  2. 6.3. 6.1 

ammo  get  hei  stowed  quantity 

Section  2.3.5. 1.9 

ammo  qet  apds  stowed  quantity 

Section  2.3. 5. 1.8 

ammo  qet  tow  stowed  quantity 

Section  2.3.5.1.10 

ammo  qet  draqon  stowed  quantity 

Section  2.3.5.1.11 

network  send  offer  packet 

Section  2.1.1.3.1.40.1 

ammo  start  external  send 

Section  2.3.5.1.75 

Table  2.3-223: 


resupply_feed_me_packet  Information. 
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2.3.5.3.15  resupply_gating_conditions 

This  routine  returns  TRUE  if  the  vehicle  is  not  moving  and  there  are  no  failures  in  the 
controls.  The  routine  returns  FALSE  if  the  vehicle  is  moving  or  there  is  a  failure  in  the 
controls. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

tracks  speed 

REAL 

sim  types. h 

Return  Values 

Return  Value 

Type 

Meanina 

TRUE 

BOOLEAN 

the  vehicle  is  not  moving;  no 
failures  in  the  controls 

FALSE 

BOOLEAN 

either  the  vehicle  is  moving  or 
there  is  a  controls  failure 

Calls 

Function 

Where  Described 

drivetrain  qet  vehicle  speed 

Section  2.3.6.2  4.8 

controls  failure  status 

Section  2.3.2 

Table  2.3-224; 


resuppIy_gating_conditions  Information. 
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2.3.5.3.16 


ainmo_receive_quiet_state 


This  routine  determines  the  receiver's  ammunition  resupply  Finite  State  Machine's  QUIET 
state.  If  the  following  conditions  are  ALL  TRUE: 

•  The  resupply  gating  conditions  are  TRUE  (the  vehicle  is  alive,  the  vehicle  is  not 
moving,  and  no  controls  failures  exist). 

•  There  are  ammo  carriers  nearby. 

•  The  receiver  is  ready  to  receive  ammo  (the  commander  has  set  the  transfer  mode 
to  receive,  the  turret  drive  system  is  off,  and  there  is  room  for  the  ammo). 

•  If  TOW  missiles  are  requested,  the  TOW  launcher  is  up. 

Then,  send  a  feed  me  packet  to  the  ammo  carriers  on  the  network,  start  the  resupply  timer, 
and  enter  the  REQUEST  state.  If  any  of  the  conditions  are  not  met,  remain  in  the  QUIET 
state. 


1  Return  Values  1 

Return  Value 

Type 

Meaninq 

REQUEST 

int 

the  receiver  is  in  the 

REQUEST  state 

QUIET 

int 

the  receiver  is  in  the  QUIET 
state 

1  Calls  1 

■  Function  1 

Where  Described 

Section  2.3.5.3.15 

ammo  ready  to  external  resupply 

Section  2.3.5.1.70 

ammo  decide  round  type 

Section  2.3.5.1.92 

launcher  qet  val 

Section  2.3.61. 4. 6 

timers  aet  timer 

Section  2.6.3.6.1 

send  teed  me  packets  ammo  carriers 

Section  2. 3. 5.3. 5 

Table  2.3-225:  ammo_receive_quiet_state  Information. 
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2. 3,5 .*3. 17  fuel_receive_quiet_state 

This  iDumne  determines  the  receiver's  fuel  resupply  Finite  State  Machine's  QUIET  state.  If 
the  foUwving  conditions  are  ALL  TRUE: 

>*  The  resupply  gating  conditions  are  TRUE  (the  vehicle  is  alive,  the  vehicle  is  not 
moving,  and  no  controls  failures  exist). 

•  There  are  fuel  earners  nearby. 

»  There  is  room  for  the  fuel. 

Then,  sejiid  a  feed  me  packet  to  the  fuel  carriers  on  the  network,  start  the  resupply  timer, 
and  enter  the  REQUEST  state.  If  any  of  the  conditions  are  not  met,  remain  in  the  QUIET 
state. 


1  Return  Values  1 

Return  Value 

Type 

Meanina 

REQUEST 

int 

the  receiver  is  in  the 

REQUEST  state 

QUIET 

in'. 

the  receiver  is  in  the  QUIET 
state 

1  Calls  i 

1  Function 

Where  Described 

Section  2.3.5.3.15 

fuel,  supply  full 

Section  2.3.5.2.11 

timers  oet  timer 

Section  2. 6.3. 6.1 

send  feed  me  packets  fuel  carriers 

Section  2.3.5.3.6 

Table  2.3-226:  fuel_recelve_quiet_state  Information. 
2.3.5.3.18  ammo_send_quiet_state 

This  roLEtine  determines  the  sender's  ammunition  resupply  Finite  State  Machine's  QUIET 
state.  If  the  following  conditions  are  ALL  TRUE; 

*  The  resupply  gating  conditions  are  TRUE  (the  vehicle  is  alive,  the  vehicle  is  not 
moving,  and  no  controls  failures  exist). 

*  There  are  ammo  receivers  nearby. 

*  The  ammo  is  ready  to  be  sent. 

Then,  eanter  the  WAITING  state.  If  any  of  the  conditions  are  not  met,  remain  in  the  QUIET 
state. 


1  Return  Values  1 

Return  Value 

Type 

Meanlnq 

WAITING 

int 

the  sender  is  in  the  WAITING 
state 

QUIET 

int 

the  sender  is  in  the  QUIET 
state 

Calls 

Function 

Where  Described 

resuppi/  qatinq  conditions 

Section  2.3.5.3.15 

ammo  -  eadv  to  external  send 

Section  2.3.5.1.72 

iablo  2.3-227  animo  stnd  qiiicl  state  Information. 
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2.3.5.3.19 


amm6_receive_request_state 


This  routine  determines  the  receiver's  ammunition  resupply  Finite  State  Machine’s 
REQUEST  state.  If  ANY  of  the  following  conditions  are  TRUE: 

•  The  resupply  gating  conditions  are  FALSE  (the  vehicle  is  dead,  the  vehicle  is 
moving,  or  a  controls  failure  exists). 

•  There  are  no  ammo  carriers  nearby. 

•  The  receiver  is  not  ready  to  receive  ammo  (the  commander  has  not  set  the  transfer 
mode  to  receive,  the  turret  drive  system  is  on,  or  there  is  no  room  for  the  ammo). 

Then,  abort  the  resupply  timer  and  enter  the  QUIET  state.  If  none  of  the  conditions  are  met 
and  the  resupply  timer  has  expired,  send  another  service  request,  restart  the  timer,  and 
remain  in  the  REQUEST  state.  If  the  resupply  timer  has  not  expired,  remain  in  the 
REQUEST  state. 


1  Return  Values  1 

Return  Value 

Meaning 

QUIET 

int 

the  receiver  is  in  the  QUIET 
state 

REQUEST 

int 

the  receiver  is  in  the 

REQUEST  state 

1  Calls  1 

■  Function 

Where  Described 

Section  2.3.5.3.15 

ammo  readv  to  external  resuppiv 

Section  2.3.5.1.70 

timers  aet  timeout  edoe 

Section  2.6.3.22.1 

timers  free  timer 

Section  2.6  3.5.1 

timers  aet  timer 

Section  2.6.3.6.1 

send  feed  me  packets  ammo  carriers 

Section  2.3.5.3.6 

Table  2.3-228:  ammo_receive_request_state  Information. 
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2.3. 53 . 2  0  fuel^recei  ve_request_sta te 


This  louidne  determines  the  receiver's  fuel  resupply  Finite  State  Machine's  REQUEST 
state.  Hf  ANY  of  the  following  conditions  are  TRUE: 

*•  The  resupply  gating  conditions  are  FALSE  (the  vehicle  is  dead,  the  vehicle  is 
moving,  or  a  controls  failure  exists). 

•  There  are  no  fuel  carriers  nearby. 

«  The  fuel  supply  is  full. 

Then,  abxnt  the  resupply  timer  and  enter  the  QUIET  state.  If  none  of  the  conditions  are  met 
and  the  Resupply  timer  has  expired,  send  another  service  request,  restart  the  timer,  and 
remain  in  the  REQUEST  state.  If  Ae  resupply  timer  has  not  expired,  remain  in  the 
REQUEST  state. 


1  Return  Values  1 

Return  Value 

Meanina 

REQUEST 

int 

the  receiver  is  in  the 

REQUEST  state 

QUIET 

int 

the  receiver  is  in  the  QUIET 
state 

1  Calls  1 

1  Function  1 

Where  Described 

Section  2.3.5.3.15 

fuel  suptoly  full 

Section  2.3.5.2.11 

timers  free  timers 

Section  2.6.3.5.1 

timers  aiet  timeout  edqe 

Section  2.6.3.22.1 

timers  cdst  timer 

Section  2.6.3.6.1 

send  fee?d  me  packets  fuel  carriers 

Section  2.3.5.3.6 

Table  2.3-229:  fuel_receive_request_state  Information. 
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2.3.5.3.21 


amino_send_waiting_state 


This  routine  determines  the  sender's  ammunition  resupply  Finite  State  Machine's 
WAFTING  state.  If  ANY  of  the  followLig  conditions  are  TRUE: 

•  The  resupply  gating  conditions  are  FALSE  (the  vehicle  is  dead,  the  vehicle  is 
moving,  or  a  controls  failure  exists). 

•  There  are  no  ammo  receivers  nearby. 

•  The  sender  is  not  ready  to  send  ammo  (there  are  insufficient  supplies  to  send). 
Then,  enter  the  QUIET  state.  If  none  of  the  conditions  are  met  remain  in  tiie  WAITING 
state. 


1  Return  Values  1 

Return  Value 

Meaning 

QUIET 

int 

the  sender  is  in  the  QUIET 
state 

WAITING 

int 

the  sender  is  in  the  WAITING 
state 

1  Calls  1 

Function 

Where  Described 

resupply  patina  conditions 

Section  2.3.5.3.15 

ammo  ready  to  external  send 

Section  2.3.5.1.71 

Table  2.3-230:  ammo_send_waiting_state  Inform  tion. 
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2.3.5.3.22  ammo_recei ve_loa ding_state 

This  routine  determines  the  receiver's  ammunition  resupply  Finite  State  Machine's 
LOADING  state.  If  the  ammo  has  been  received,  a  thank  you  packet  is  sent  by  the  receiver 
listing  the  type  and  amount  of  ammunition  taken,  and  the  receiver  enters  the  QUIET  state. 

If  any  of  ANY  of  the  following  conditions  have  changed  to  TRUE  in  the  LOADING  state: 

•  The  resupply  gating  conditions  are  FALSE  (the  vehicle  is  dead,  the  vehicle  is 
moving,  or  a  controls  failure  exists). 

•  There  are  no  ammo  carriers  nearby. 

•  The  ammo  carrier  which  offered  ammunition  is  dead. 

•  The  receiver  is  no  longer  ready  to  receive  ammo  (the  commander  has  not  set  the 
transfer  mode  to  receive  or  the  turret  drive  system  is  on). 

Then,  stop  the  resupply  and  enter  the  QUIET  state. 

If  the  loading  has  not  completed,  remain  in  the  LOADING  state. 


1  Internal  Variables  I 

Variable 

Where  Tvpedef  Declared 

munitions 

basic.h 

1  Return  Values  1 

Return  Value 

Meaning 

QUIET 

int 

the  sender  is  in  the  QUIET 
state 

LOADING 

int 

the  sender  is  in  the  LOADING 
state 

1  Errors  1 

Error 

Reason  for  Error 

AMMO:  ammo  receive  loading  state 

impossible  ammo  that  was  received 

1  Calls  1 

Function 

Where  Described 

network  send  thank  you  packet 

Section  2.1.1.3.1.41.1 

resupply  oating  conditions 

Section  2.3.5.3.15 

vehicle  is  close 

Section  2.3.5.3.34 

ammo  ready  to  external  resupply 

Section  2.3.5.1.70 

Section  2.3.5.1.76 

Table  2.3-231: 


ammo_receive_loading_state  Information. 
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2.3.5.3.23  fuel_receive_Ioading_state 

This  routine  determines  the  receiver's  fuel  resupply  Finite  State  Machine's  LOADING 
state.  If  the  fuel  has  been  received,  a  thank  you  packet  is  sent  by  the  receiver  listing  the 
quantity  of  fuel  taken,  and  the  receiver  enters  the  QUIET  state. 

If  any  of  ANY  of  the  following  conditions  have  changed  to  TRUE  in  the  LOADING  state: 

•  The  resupply  gating  conditions  are  FALSE  (the  vehicle  is  dead,  the  vehicle  is 
moving,  or  a  controls  failure  exists). 

•  There  are  no  fuel  carriers  nearby. 

•  The  fuel  which  offered  fuel  is  dead. 

•  The  fuel  load  is  full. 

Then,  stop  the  resupply  and  send  a  thank  you  packet  listing  the  quantity  of  fuel  taken 
before  the  resupply  was  stopped  and  enter  the  QUIET  state. 

If  the  loading  has  not  completed,  remain  in  the  LOADING  state. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

munition 

basic.h 

1  Return  Values  1 

Return  Value 

Meanina 

QUIET 

int 

the  sender  is  in  the  QUIET 
state 

LOADING 

int 

the  sender  is  in  the  LOADING 
state 

1  Calls  1 

Function 

Where  Described 

network  send  thank  you  packet 

Section  2.1.1.3.1.41.1 

Section  2.3.5.3.15 

fuel  supply  full 

Section  2.3.5.2.11 

vehicle  is  close 

Section  2.3.5.3.34 

Section  2.3.5.2.14 

Table  2.3-232; 


fuel_receive_loading_state  Information. 
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2.3.5.3.24  ammo_send_servicing_state 

This  routine  determines  the  sender's  ammunition  resupply  Finite  State  Machine's 
SERVICING  state.  If  the  resupply  timer  has  timed  out,  stop  the  resupply  and  enter  the 
QUIET  state.  If  the  resupply  timer  has  not  timed  out,  remain  in  the  SERVICING  state. 


1  Return  Values  I 

Return  Value 

Type 

Meanina 

QUIET 

int 

the  sender  is  in  the  QUIET 
state 

SERVICING 

int 

the  sender  is  in  the 

SERVICING  state 

Calls 

Function 

Where  Described 

timers  oet  timeout  edae 

Section  2.6.3.22.1 

timers  free  timers 

Section  2. 6.3.5. 1 

ammo  stop  resupply 

Section  2.3.5.1.76 

Table  2.3-233:  ammo_send_servicing_state  Information. 
2.3.5.3.25  ammo_resupply_receive_simul 

This  routine  runs  the  ammunition  resupply  receive  simulation.  The  routine  checks  the 
ammo  resupply  receive  state  and  calls  the  appropriate  routine  for  that  state. 


1  Errors  I 

Error 

Reason  for  Error 

REPAIR;  ammo  resupply,  receive  simul 

unknown  state 

Calls 

Function 

Where  Described 

ammo  receive  auiet  state 

Section  2.3.5.3.16 

ammo  receive  request  state 

Section  2.3.5.3.19 

ammo  receive  loadinq  state 

Section  2.3.5.3.22 

Table  2.3-234:  ammo_resupply_receive_simul  Information. 
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2.3.5.3.26  fuel_resupply_receive_simul 

This  routine  runs  the  fuel  resupply  receive  simulation.  The  routine  checks  the  fuel  resupply 
receive  state  and  calls  the  appropriate  routine  for  that  state. 


1  Errors  1 

[Error 

Reason  for  Error 

1  REPAIR:  fuel  resupply  receive  simul 

unknown  state 

Calls 

Function 

Where  Described 

fuel  receive  quiet  state 

Section  2.3.5.3.17 

fuel  receive  request  state 

Section  2.3.5.3.20 

fuel  receive  loadinq  state 

Section  2.3.5.3.23 

Table  2.3-235:  fuel_resupply_receive_simul  Information. 
2.3.5.3.27  ammo_resupply_send_simul 

This  routine  runs  the  ammunition  resupply  send  simulation.  The  routine  checks  the 
sender's  ammo  resupply  state  and  calls  the  appropriate  routine  for  that  state. 


I  Errors  I 

Error 

Reason  for  Error 

REPAIR:  ammo  resupply  send  simul 

unknown  state 

Calls 

Function 

Where  Described 

ammo  send  quiet  state 

Section  2.3.5.3.18 

ammo  send  waiting  state 

Section  2.3.5.3.21 

ammo  send_  servicing  state 

Section  2.3.5.3.24 

Table  2.3-236:  ammo_resupply_send_simul  Information. 
2.3.5.3.28  resupply_init 

This  routine  initializes  the  resupply  simulation.  All  ammo  and  fuel  carriers  and  receivers 
are  cleared,  all  resupply  states  are  set  to  QUIET,  and  all  resupply  timers  are  set  to  NULL. 


1  Calls  1 

Function 

Where  Described 

clear  ammo  carriers 

Section  2.3.5.3.1 

clear  fuel  carriers 

Section  2.3.5.3.2 

clear  ammo  receivers 

Section  2.3.5.3  3 

Table  2.3-237:  resupply_init  Information. 
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2.3.5.3.29  resupply_siinul 

This  routine  nuns  the  resupply  simulations.  The  routine  calls  the  ammo  send,  ammo 
receive  simul^on  ,  and  fuel  receive  routines. 


1  Calls  1 

Function 

Where  Described 

ammo  resupply  receive  simul 

Section  2.3.5.3.25 

fuel  resupply  receive  simul 

Section  2.3.5.3.26 

ammo  resupply  send  simul 

Section  2.3.5.3.27 

clear_ammo  carriers 

Section  2.3.5.3.1 

clear  fuel  carriers 

Section  2.3.5.3.2 

clear  ammo  receivers 

Section  2.3.5.3.3 

Table  2.3*238:  resupply_simul  Information. 

2.3.5.3.29  »ervice_checfc_vehicle_ty pe 

This  routine  cfeecks  the  vehicle  ID  from  the  pkt  parameter,  determines  its  vehicle  type,  and 
updates  the  difiasrent  lists  of  ck»se  vehicles  (ammo  carriers,  fuel  carriers,  ammo  receivers, 
etc.). 


Parameters  I 

Parameter 

Where  Tvpedef  Declared 

pkt 

pointer  to 

VehicleAppearanceVariant 

p_sim.h 

I  Internal  Variables  I 

Variable 

Where  Tvpedef  Declared 

id 

pointer  to  VehiclelD 

basic.h 

I  Return  Values  I 

Return  Value 

Type 

Meaning 

TRUE 

int 

Successful 

I  Calls  I 

Function 

Where  Described 

is  fuei  vehicle 

Section  2.6.10.7.1 

resupply  near  ’isjel  carrier 

Section  2.3.5.3.8 

BdUd 

Section  2.6.10.10.1 

I  repair  near  repair  I 

Section  2.3.4.2.5 

Section  2.6.10.2.1 

is  ammo  carrier 

Section  2.6.10.2.2 

resupply  near  ammo  carrier 

Section  2.3.5.3.8 

is  main  battle  tank 

Section  2.6.10.9 

resupply  near  .-iimmo  receiver 

Section  2.3,5.3.9 

Tal>le  2.3-239:  ser  ’c»-  check  vehicic  type  Information. 
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2.3.5.3.30  resup piy_stop_ammo_resupply 

This  routine  aborts  the  ammo  resupply  simulation,  resetting  the  ammo  resupply  send  (or 
receive)  state  to  QUIET  and  fireeing  the  resupply  timer. 


1  Calls  1 

Function 

Where  Described 

timers  free  timers 

Section  2.6.3.5.1 

Table  2.3>240:  resuppIy_stop_ainmo_resupply  Information. 
2.3.5.3.31  resupply_stop_f  uel_resupply 

This  routine  aborts  the  fuel  resupply  simulation,  resetting  the  fuel  resupply  receive  state  to 
QUIET  and  freeing  the  resupply  timer. 


1  Calls  1 

Function 

Where  Described 

timers  free  timers 

Section  2.6.3.5.1 

Table  2.3-241:  resupply_stop_fuel_resupply  Information. 
2.3.5.3.32  resupply_offer_canceled 

This  routine  cancels  an  offer  of  service  from  another  vehicle. 


I  Parameters  I 

Parameter 

Where  Tvoedef  Declared 

carrier  id 

int 

Standard 

Table  2.3-242:  resup ply_offer_canceled  Information. 


2.3.5.3.33  resupply_request_canceled 

Tiiic  routine  cancels  a  request  for  service. 


I  Parameters  I 

Parameter 

Where  Typedef  Declared 

receiverfid 

int 

Standard 

Table  2.3-243:  resupply_request_canceled  Information. 
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2.3.5.3.34  vehicIe_is_close 

This  routine  determines  if  a  particular  vehicle  is  on  the  close  vehicles  list. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

list 

reqister  pointer  to  VehiclelD 

basic.h 

vehicle 

reaister  pointer  to  VehiclelD 

basic,  h 

size  of  list 

reaister  int 

Standard 

1  Return  Values  1 

Return  Value 

Meanina 

TRUE 

int 

The  vehicle  is  on  the  close 
vehicles  list 

FALSE 

int 

The  vehicle  is  not  on  the  close 
vehicles  list 

1  Calls  1 

Function 

Where  Described 

VEHICLE  IDS  EQUAL 

Macro  defined  in  sim  macros.h 

Table  2.3-244;  vehicIe_is_close  Information. 

2.3.5.3.35  key brd_ammo_ca rriers_near_here 

This  routine  returns  whether  any  ammo  carriers  are  nearby,  prompted  by  a  user’s  keyboard 
request. 


1  Return  Values  1 

Return  Value 

Type 

Meanina 

ammo_carriers_near_here 

BOOLEAN 

Whether  any  ammo  carriers  are 
nearby 

Table  2.3-245;  keybrd_ammo_carriers_near_here  Information. 
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2.3.6  M2  Vehicle  Model 

There  are  a  number  of  vehicle  specific  simulation  functions.  Code  is  required  for  modeling 
the  relevant  moving  elements  of  a  vehicle.  It  is  necessary  to  simulate  the  forces  applied  to 
the  vehicle  by  its  propulsion  and  suspension  systems.  The  generation  and  use  of  electric 
and  hydraulic  power  is  simulated,  as  are  the  effects  of  the  user’s  actions  on  the  visual 
displays. 


M1  Vehicle  Model 
5.3.6 


Internal 

Kinematics 

Propulsion 

Simulation 

Vehicle 

Subsystems 

5.3.6.1 

5.3.6.2 

5.3.6.3 

—  m2  turret.c 

5.3.6.1.1 

—  m2_ptrain.c 

5.3.6.2.1 

—  m2  elecsys.c 
5.3.6.3.1 

—  m2  cupola.c 

5.3.6.1.2 

—  m2_trans.c 

5.3.6.2.2 

—  .m2  vision.c 
5.3.6.3.2 

—  m2_ramp.c 

5.3.6.1.3 

—  m2_cntrllr.c 

5.3.6.2.3 

—  m2_isu.c 
5.3.6.3.3 

—  m2  launcher 

5.3.6.1.4 

—  m2_dtrain.c 

5.3.6.2.4 

—  m2_6ngine.c 

5.3.6.2.5 

—  m2_engfail.c 

5.3.6.2.6 

Figure  2.3-7;  Structure  of  the  M2  Vehicle  Model  CSC. 

The  third  level  CSC's  are  as  follows: 

Internal  Kinematics 
Propulsion  Simulation 
Vehicle  Subsystems 
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2. 3. 6.1  briternal  Kinematics 

The  M2  has  components  which  move  with  respect  to  the  hull.  The  turret  and  the  TOW 
launcher  on  thte  M2  are  examples.  It  is  necessary  to  model  the  movement  of  these 
components;  Ikowever,  the  required  level  of  model  fidelity  varies  among  them.  A  much 
more  detail^  imodel  is  required  for  the  turret  than  for  the  TOW  launcher.  The  simulation  of 
moving  components  is  carried  out  by  the  following  CSU's 

m2_jwirret.c 
m2_icupola.c 
m2_n5imp.c 
m2 Jiauncher.c 

2.3.6. 1.1  m2_turret.c 

<ysimnet/release/src/vehicle/m2/src/m2_turret.c  [m2_turret.c]) 

The  vehicle  specific  characteristics  of  the  turret  are  modeled  in  m2_turret.c.  The  vehicle 
specific  code  responds  to  commands  from  the  controls  and  determines  the  appropriate 
commands  to  s>end  to  libturret.  The  response  depends  on  the  mode  of  operation  of  the 
turret  and  is  affected  if  a  turret  subsystem  has  faded.  The  operational  modes  and  failure 
status  are  tracked  in  vehicle  specific  code.  Commands  are  sent  to  the  sound  system  from 
this  module.  TFnis  module  contain  functions  which  provide  information  to  other 
components  off  the  simulation,  including  the  CIG  and  some  of  the  control  displays. 

Includes: 


"stdio.lf." 

"math.ln'' 

"sim_t5s-pes.h" 

"sim_difns.h" 

"sim_rtriacros.h" 

"timei55:-h" 

"timersi-_dfn.h" 

"pro_dtita.h" 

"iibtunret.h" 

"libmatrix.h" 

"bigwh&eel.h" 

"libkin.;h" 

Defines: 

TURRCT.DEBUG 
TURK  £T_F  A  Tl.URES_DEBUG 
STAB  DEBUG 
GUN_BREAK_SPEED 

Declarations: 

gyro.jspeed 
gun_S'iCw__l'  ukIIc 
gun_c‘:iev.. handle 
turret  ...slew  me 
gun_c'"y..r:i:c 
super .elev 
,sin..is  .;..el‘ 


"libfailh" 

"failure.h" 

"libsound.h" 

"m2_alpha.h" 

’'m2_bcs.h" 

’’m2_dtrain.h" 

"m2_elecsys.h" 

"m2_sound.h" 

"m2_sound_dfn.h" 

"m2_turr_def.h" 

"m2_turret.h" 

"m2_main.h" 


“  between  0.0  and  1.0 

-  between  -1.0  and  1.0 

-  between  - 1 .0  and  1 .0 

-  radians  per  frame 

-  radians  per  frame 

radians  of  elevation.s  (relative  to  the 
orientation  of  the  hull) 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


sin_gun_elev 
sin  tow  elev 


sin  elev_rads 


tow_movement  --  IKi 

fast_movement  —  TRl 

gun_on_stop  —  TRl 

elevation_status  -  eith 

stab_status  --  eith 

mount_int_status  —  eith^ 

gearbox_status  —  eith 

traverse_status  -  eith 

stab_power  -  ON 

controLengaged  --  ON 

caIc_elev_froni_handle() 
caIc_siew_from_handle() 
turret_gyros_simuI() 
turret_niove() 
turret_calc_gun_eiev() 
turret_calc~turret_slew() 
make_sound_of_no_turret  noise() 
make_sound_of  no_eIevatrng() 
make”sound”orno_slewing() 

2.3.6. 1.1.1  turret  init 


radians  of  elevations  (relative  to  the 

orientation  of  the  hull) 

radians  of  elevations  (relative  to  the 

orientation  of  the  hull) 

number  of  radians  that  the  gun  is  elevated 

(relative  to  the  orientation  of  the  hull) 

TRUE  or  FALSE 

TRUE  or  FALSE 

TRUE  or  FALSE 

either  WORKING  or  BROKEN 

either  WORKING  or  BROKEN 

either  WORKING  or  BROKEN 

either  WORKING  or  BROKEN 

either  WORKING  or  BROKEN 

ON  or  OFF 

ON  or  OFF 


This  routine  initializes  the  turret  variables.  The  stab  vectors  are  also  initialized  in  order  to 
use  the  stabilization  system. 


Function 


controls  turret  stab  off 


turret  set  stab  system 


fail  init  failure 


Calls 


Where  Described 


Section  2.3.2 


Section  2. 5.5. 2.3 


Section  2.5.4.11.2 


Table  2,3-246:  turret  init  Information. 
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2. 3. 6. 1.1. 2  turret_simul 

This  is  the  top  level  routine  for  the  turret.  This  routine  is  called  on  a  tick  by  tick  basis  to 
model  the  turret.  Nothing  will  occur  until  the  turret  gyros  are  operational.  When  in  manual 
mode,  the  stabilization  is  not  operational.  Note  that  the  stab  vectors  must  be  set  every  tick, 
since  they  are  set  one  tick  ahead  of  use. 


1  Internal  Variables  | 

Internal  Variable 

Where  Typedef  Declared 

old  control  value 

int 

Standard 

turret  ref  ind 

FIEAL 

Sim  types. h 

Calls 

Function 

Where  Described 

turret  avros  simul 

Section  2.3.6.1.1.11 

sound  make  const  sound 

Section  2. 1.3. 1.2 

make_sound_of_no_turret_n 

Oise 

Section  2.3.6.1.1.27 

turret  move 

Section  2.3. 6. 1.1. 3 

turret  oet  ref  ind 

Section  2.5.5.2.16 

turret  set  stab  sys 

Section  2.5.5.2.3 

controls  turret  ref  ind 

Section  2.3.2 

alpha  send 

Section  2.3.2.3.1 

Table  2.3-247:  turret_simul  Information. 

2.3.6. 1.1.3  turret_move 

This  routine  is  called  by  turret_simul()  to  make  the  turret  slew  and  the  gun  elevate.  It 
checks  to  make  sure  that  the  subsystems  are  engaged  and  working  before  the  routines 
which  actually  perform  the  slewing  and  elevating  are  called. 


1  Internal  Variables  | 

Internal  Variable 

Type 

Where  Typedef  Declared 

sin  stab  azi  rot 

REAL 

sim  types. h 

sin_stab  elev  rot 

REAL 

sim  types. h 

elev  rate 

REAL 

sim  types. h 

slew  rate 

REAL 

sim  types. h 

Calls 

Function 

Where  Described 

turret  oet  stab  chances 

Section  2.5.5.2.5 

make  sound  of  no  slewing 

Section  2.3.6.1.1.25 

turret  calcjurret  slew 

Section  2  3.6.1. 1.7 

turret  move  azimuth 

Section  2.5.5.2.6 

make  sound  of  no  elevatin 
J _ ____j 

Section  2.3.6.1.1.26 

turret  calc  gun  elev 

Section  2  3.6.1. 1.9 

turret  move  elevation 

Section  2  5.5.2.7 

Fable  2.3-248*  turret  movi  Information. 
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2.3.6. 1.1.4  turret_get_turret_slew_rate 
This  routine  retiims  the  turret  slew  rate. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

tu  rret_slew_rate/D  ELT  A_T 

REAL 

The  turret  slew  rate 

Table  2.3-249:  turret_get_turret_slew_rate  Information. 
2 . 3 . 6 . 1 . 1 . 5  turret_get_gun_elev_rate 

This  routine  returns  the  gun  elevation  rate. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

gun_elev_rate/DELTA_T 

REAL 

The  gun  elevation  rate 

Table  2.3-250:  turret_get_^gun_elev_rate  Information. 

2. 3. 6. 1.1. 6  turret_handles_values 

This  routine  is  called  by  the  handles  module  to  pass  on  the  values  of  the  gun  slew  rates,  the 
gun  elevation  rates,  which  handles  are  engaged,  and  whether  the  fast  slew  is  on. 


1  Parameters  I 

Parameter 

Where  Tvoedef  Declared 

Qun  slew  rate 

REAL 

Sim  types. h 

Qun  elevate  rate 

REAL 

Sim  tvpes.h 

handles  enaaaed 

int 

Standard 

fast  slew  on 

int 

Standard 

Table  2.3-251:  turret  handles  values  Information. 
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2 . 3 . 6 . 1 . 1 . 7  turret_calc_turret_slew 

This  routine  moves  the  turret  in  azimuth.  In  addition  to  slewing  the  turret,  this  routine  is 
also  responsible  for  checking  to  make  sure  that  the  turret  does  not  move  too  fast.  It  also 
checks  to  see  that  sufficient  hydraulic  pressure  is  available  before  starting  the  turret  move. 


Parameters 


Parameter 


control  handle 


sin  stab  azi  rot 


Internal  Variable 


total  slew  rate 


elec  slew  oercent 


IEI73 


e 


REAL 


REAL 


Internal  Variables 


lEHH 


reoister  REAL 


REAL 


Where  Tvpedef  Declared 


sim  types. h 


sim  types. h 


Where  Tvoedef  Declared 


sim  types. h 


sim  types. h 


Return  Values 


Return  Value 


total  slew  rate 


Type 


REAL 


Meaning 


The  total  slew  rate 


Calls 

Function 

Where  Described 

calc  slew  from  handle 

Section  2.3.6.1.1.8 

electsys_turret_traverse_requ 

est 

Section  2.3.6.3.1.23 

sound  of  turret  traversino 

Section  2.1.3.3.18 

Table  2.3-252:  turret_calc_turret_slew  Information. 

2.3.6. 1.1.8  calc_sIew_froni_handle 

This  routine  is  called  by  turret_move_azimuth()  to  determine  how  far  to  slew  the  turret, 
based  on  the  deflection  of  the  gunner  or  commander's  handles.  The  parameter, 
gun _slew  handle,  is  the  normdized  handle  displacement,  where  -1.0  is  complete  deflection 
to  the  right,  -»-l  is  complete  deflection  to  the  left,  and  0.0  is  centered. 


Parameters 


Parameter 


handle  dis 


11173 


reoister  REAL 


Where  Tvoedef  Declared 


sim  types. h 


Internal  Variables 


Internal  Variable 


slew  rate 


abs  slew  handle 


11173 


reoister  REAL 


reoister  REAL 


Where  Tvoedef  Declared 


sim  tvpes.h 


sim  tvpes.h 


Return  Values 


Return  Value 


slew  rate 


Type 


REAL 


Meaning 


The  slew  rate 


Tabic  2.3-253:  calc  slew  from  handle  Information. 


828 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


2. 3. 6. 1.1. 9  turret_calc_gun_elev 

This  routine  moves  the  gun  in  elevation.  In  addition  to  elevating  the  gun,  this  routine  is 
also  responsible  for  checking  that  the  gun  is  not  moving  too  fast.  The  routine  checks  for 
sufficient  hydraulic  pressure  before  elevating  the  gun. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

control  handle 

reaister  REAL 

Sim  types. h 

sin  stab  elev  rot 

reoister  REAL 

Sim  tvpes.h 

Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

total  elev  rate 

reqister  REAL 

Sim  tvpes.h 

elev  percent 

REAL 

Sim  tvpes.h 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

totaLelev_rate 

REAL 

the  total  elevation  rate 

1  Calls  1 

Function 

Where  Described 

calc  elev  from  handle 

Section  2.3.6.1.1.10 

eelctsys_turret_elevation_req 

uest 

Section  2.3.6.3.1.22 

sound  of  oun  elevatino 

Section  2.1.3.3.17 

Table  2.3-254:  turret_calc_gun_elev  Information. 


2.3.6.1.1.10  calc_elev_from_handle 

This  routine  is  called  by  turret_move_elev()  to  determine  how  far  to  elevate  the  gun, 
based  on  the  deflection  of  the  gunner  or  commander's  handles.  The  parameter, 
gm  elev  handle,  is  the  normalized  handle  displacement,  where  -1.0  is  complete  deflection 
to  the  right,  +1  is  complete  deflection  to  the  left,  and  0.0  is  centered. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

handle  disp 

register  REAL 

Sim.  tvpes.h 

1  Internal  Variables  | 

Internal  Variable 

Where  Typedef  Declared 

elev  rate 

register  REAL 

Sim  tvpes.h 

abs  elev  handle 

register  REAL 

simjypes.h 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

elev_rate 

REAL 

The  elevation  rate 

Table  2.3-255:  calc  elev  from  handle  Information. 
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2.3.6.1.1.11  turret_gyros_simul 

This  routine  is  called  by  turret_simul()  to  simulate  the  spinning  up  or  spinning  down  of 
the  turret  gyros.  The  variable,  gyro  speed,  is  a  number  between  0.0  and  1.0,  representing 
the  gyros'  speed  as  a  percentage  of  their  full  working  speed. 


1  Internal  Variables  I 

Internal  Variable 

Where  Typedef  Declared 

a  dir 

pointer  to  reaister  int 

Standard 

Q  speed 

pointer  to  register  REAL 

Sim  types. h 

1  Return  Values 

Return  Value 

Type 

Meaning 

turret^yros_status 

int 

The  status  of  the  gyros 

Function _ 

turret  gyros  status _ 

controls_turret_drive_system 
on _ 


_ Calls 

Where  Described 
Section  2.3.6.1.1.16 
Section  2.3.2 


Table  2.3-256:  turret_gyros_simuI  Information. 

2.3.6.1.1.12  turret_stab_on 

This  routine  called  by  the  controls  module  when  the  stab  switch  is  turned  on. 


1  Calls  1 

Function 

Where  Described 

controls  turret  stab  on 

Section  2.3.2 

Table  2.3-257:  turret  stab  on  Information. 


2.3.6.1.1.13  turret_stab_off 

This  routine  called  by  the  controls  module  when  the  stab  switch  is  turned  off. 


1  Calls  1 

Function 

Where  Described 

controls  turret  stab  off 

Section  2.3.2 

Table  2.3-258:  turret_stab_off  Information. 

2.3.6.1.1.14  turret_gyros_spool_up 

This  routine  called  by  the  controls  module  when  the  turret  power  is  turned  :>n,  in  order  u> 
spool  up  the  turret  gyros. 
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2.3.6.1.1.15  tu rret_gy ros_spooI_down 

This  routine  called  by  the  controls  module  when  the  turret  power  is  turned  off,  in  order  to 
spool  fown  the  turret  gyros. 


1  calls  1 

Function 

Where  Described 

controls  turret  drive  system 
off 

Section  2.3.2 

Table  2.3-259:  turret_gyros_spooI_down  Information. 
2.3.6.1.1.16  turret_gyros_status 

This  routine  is  called  by  the  controls  module  to  determine  the  state  of  the  turret  gyros. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

GYROS_SPOOLED_U  P 

int 

The  gyros  are  spooled  up 

GYROS_SPOOLED_DOWN 

int 

The  gyros  are  spooled  down 

GYROS_STILL_SPOOLING 

int 

The  gyros  are  in  the  process 
of  spooling 

Table  2.3-260:  turret_gyros_status  Information. 

2.3.6.1.1.17  turret_break_elevation_drive 
This  routine  causes  the  elevation  drive  to  fail. 

2.3.6.1.1.18  turret_repair_eIevation_drive 
This  routine  causes  the  elevation  drive  to  be  repaired. 

2.3.6.1.1.19  tu rret_break_stab_system 
This  routine  causes  the  stabilization  system  to  fail. 

2.3.6.1.1.20  tu r ret_repai r_sta b_system 

This  routine  causes  the  stabilization  system  to  be  repaired. 

2.3.6.1.1.21  turret_break_mount_interface 
This  routine  causes  the  mount  interface  to  fail. 

2.3.6.1.1.22  turret_repai r_mount_interface 
This  routine  causes  the  mount  interface  to  be  repaired. 

2.3.6.1.1.23  turret_break_t ra verse_dri ve 
This  routine  causes  the  traverse  drive  to  fail. 
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2.3.6.1.1.24  turret_repair_tra verse_dri ve 
This  routine  causes  the  traverse  drive  to  be  repaired. 

2.3.6.1.1.25  turret_collision_detected 

This  routine  is  called  whenever  kinematics  whenever  a  collision  is  detected.  It  determines 
whether  the  gun  was  pointing  in  the  direction  of  the  collision.  If  so,  the  routine  checks  to 
see  whether  to  break  the  turret-mount  interface.  When  the  turret-mount  interface  is  brolren, 
the  gun  catmot  be  elevated  (except  in  emergency  mode)  or  fired. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

aaent  id 

pointer  to  Vehicle!  0 

basic.h 

event  id 

Iona 

Standard 

coll  sector 

register  int 

Standard 

Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

azimuth 

register  REAL 

Sim  tvpes.h 

rel  sector 

register  int 

Standard 

t  to  h 

register!  MAT  PTR 

Sim  tvpes.h 

1  Calls  1 

Function 

Where  Described 

rad_to  mil 

Macro  defined  in  sim  macros,  h 

drivetrain  qet  venicle  speed 

Section  2.3.6.2.4.8 

fail  break  system 

Section  2.5.4.8.1 

Table  2.3-261:  turret_collisIon_detected  Information. 
2.3.6.1.1.25  make_sound_of_no_slewing 
This  routine  makes  the  sound  of  the  turret  not  traversing. 


1  Calls  i 

Function 

Where  Described 

sound  of  turret  traversing 

Section  2.1.3.3.18 

Table  2.3-262:  make_sound_of_no_slewing  Information. 
2.3.6.1.1.26  make_sound_of_no_elevating 

This  routine  makes  the  sound  of  the  gun  not  elevating. 


I  Calls  I 

Function 

Where  Described 

sound  of  gun  elevating 

Section  2.1.3.3.17 

Table  2.3-263:  make  sound  of  no  elevating  Information. 
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2.3.6.1.1.27  make_sound_of_no_turret_noise 

This  routine  makes  the  sound  of  the  gun  not  elevating  and  the  turret  not  traversing. 


1  Calls  1 

Function 

Where  Described 

make  sound  of  no  slewina 

Section  2.3.6.1.1.25 

make_sound_of_no_elevatin 

Q 

Section  2.3.6.1.1.27 

Table  2.3-264:  make_sound_of_no_turret_noise  Information. 
2.3.6.1.1.28  turrret_get_gun_to_world 

This  routine  returns  the  gun  to  world  transformation  matrix. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

Q  to  W 

T  MATRIX 

sim_types.h 

error 

VECTOR 

Sim.  types. h 

Internal  Variables 

Internal  Variable 

Where  Tvpedef  Declared 

super  elevation 

REAL 

Sim  types 

1  Calls  1 

Function 

Where  Described 

bcs  qet  super  elevation 

Section  2.3.3.1 

turret  qet  q  to  w 

Section  2.5.5.2.13 

Table  2.3-265:  turret_get_gun_to_world  Information. 

2.3.6.1.1.29  tu r ret_tow_movement_off 

This  routine  is  called  by  the  ammunition  module  when  the  25mm  gun  is  selected  or  no 
ammo  is  selected. 

2.3.6.1.1.30  tur ret_tow_movement_on 

This  routine  is  called  by  the  ammunition  module  when  the  TOW  missile  is  selected. 
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2.3.6.1.1.31  turret_set_super_eIevation 

This  routine  is  called  by  the  ballistics  computer  system  when  the  superelevation  changes. 


j  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

new  super  elev 

REAL 

Sim  tvpes.h 

Calls 

Function 

Where  Described 

turret  move  elevation 

Section  2.5.5.2.7 

Table  2.3-266:  turret_set_super_elevation  Information. 
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2. 3. 6. 1.2  in2_cupola.c 

(./siinn^rclease/srcA^ehicle/m2/src/in2_cupola.c  [m2_cupola.c]) 

The  commander's  periscope  views  in  the  M2  hatch  are  modelled  by  a  rotating  cupola  with 
viewports  attached  to  it  The  commander  turns  the  cupola  by  pressing  a  switch.  The 
ctmtrols  code  determines  the  position  of  the  cupola  as  a  percentage  of  its  full  range. 
M2_cupok.c  determine  the  angle  of  the  cupola  with  respect  to  the  turret  from  this 
information.  The  sine  and  cosine  are  made  available  to  the  CIG  so  the  appropriate  image 
can  be  drawn  in  the  periscope  viewports. 

Includes: 

"stdio.h" 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 


Defines: 

Symbol 

CWS_FIELD_OF_VIEW 


REAL  declarations  and  initialization: 
cws_sin  =  0.0 
cws_cos  =  1.0 
cws_current_offset  =  0,0 


int 


declarations  and  initialization: 
new_cws_value  =  TRUE 


Value 

5.235987755  300  deg 


2.3.6. 1 .2 . 1  cupoIa_get_cws_cos_and_sin 

This  routine  sets  the  values  pointed  to  by  sine  and  cosine  to  commander  weapon  system 
sine  and  cosine. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

cosine 

pointer  to  fioat 

Standard 

sine 

pointer  to  float 

Standard 

Table  2.3-267:  cupola_get_cws_cos_and_sin  Information. 
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2 . 3 . 6 . 1 . 2 . 2  cupoIa_get_reaI_cws_cos_and_sin 

This  routine  sets  the  values  pointed  to  by  sine  and  cosine  to  commander  weapon  system 
sine  and  cosine. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

cosine 

pointer  to  REAL 

Sim  tvpes.h 

sine 

pointer  to  REAL 

Sim  tvpes.h 

Table  2.3-268:  cupola_get_real_cws_cos_and_sin  Information. 


2. 3. 6. 1.2. 3  convert_disp_to_angle 

This  routine  sets  the  values  pointed  to  by  psin  and  pcos  to  the  sine  and  cosine  of  the  angle 
caluclated  from  the  displacement  and  offset  arguments  (disp  and  offset) 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

disp 

REAL 

Sim  tvpes.h 

fov 

REAL 

Sim  tvpes.h 

psin 

pointer  to  REAL 

Sim  tvpes.h 

pcos 

pointer  to  REAL 

Sim  tvpes.h 

offset 

REAL 

Sim  tvpes.h 

- - -  , 

Internal  Variables  1 

1  Internal  Variable 

Type 

Where  Typedef  Declared 

reqister  REAL 

sim  tvpes.h 

Table  2.3-269:  convert_disp_to_angle  Information. 


2. 3. 6. 1.2. 4  cupola_cws_new_value 

This  routine  sets  the  value  of  the  commander  weapon  system  offset  to  the  value  passed  in 
val. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

val 

REAL 

sim  tvpes.h 

Table  2.3-270:  cupola_cws_new_value  Information. 
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2.3.6. 1.2.5  cupola_simul 

This  routine  performs  the  tick  by  tick  simulation  of  the  cupola.  The  routine  determines 
whether  the  cupola  moved,  and  if  so,  the  routine  calculates  the  new  commander  weapon 
system  sine  and  cosine. 


1  Calls  1 

Function 

Where  Described 

convert  diso  to  anale 

Section  2.3.6.1.2.3 

Table  2.3-271:  cupola_simul  Information. 


2. 3. 6. 1.2. 6  cupola_init 

This  routine  initializes  the  value  of  the  commander  weapon  system  offset  at  0.0. 
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2.3.6. 1.3  m2_rainp.c 

(./simn^release/src/vehicle/m2/src/m2_ramp.c  [m2_ramp.c]) 

The  level  of  fidelity  of  the  M2  ramp  model  is  rather  low.  The  issues  of  concern  are 
whether  or  not  the  ramp  is  moving  and  if  it  is  fully  open,  fully  closed  or  somewhere  in 
between.  It  is  not  necessary  to  track  the  exact  position.  The  riKxlel  is  maintained  in 
m2jramp.c.  It  responds  to  commands  from  controls  to  move  or  stop  the  ramp  if  possible. 
It  tracks  the  time  required  to  open  or  close  the  ramp  and  it  makes  the  appropriate  sounds 
associated  with  ramp  movement  and  stopping.  It  tells  the  controls  when  a  stop  is  reached 
and  provides  a  routine  to  return  the  ramp  status. 

Includes: 

"stdio.h" 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 

"libsound.h" 

"ni2_ramp.h" 

"m2_cntrl.h" 

"m2_sound_dfn.h" 

Defines:  DELTA_RAMP 

Declarations: 

ramp_val 

ramp_gomg_up 

ramp_going_down 

2.3.6. 1.3.1  ramp_init_ranip_down 

This  routine  sets  the  ramp  val  based  on  the  position  status  of  the  ramp  (either  up  or  down). 


I  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

down  status 

int 

Standard 

ramp_init_ramp_down  Information. 


Table  2.3-272: 
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2.3.6. 1.3.2  ramp_simul 

This  routine  is  called  on  a  tick  by  tick  basis  to  provide  the  ramp  simulation.  The  routine 
checks  the  position  of  the  ramp.  If  the  ramp  is  going  up,  the  sound  of  the  rear  ramp 
stopping  in  the  raised  position  is  made;  if  the  ramp  is  going  down,  the  sound  of  the  rear 
ramp  stopping  in  the  lowered  position  is  made.  If  the  ramp  is  fully  raised,  controls  is 
notified  to  lock  the  ramp. 


1  Calls  1 

Function 

Where  Described 

sound  make  const  sound 

Section  2. 1.3. 1.2 

controls  ramp  unlocked  on 

Section  2.3.2 

controls  ramp  locked  on 

Section  2.3.2 

Table  2.3-273:  ramp_simul  Information. 

2. 3. 6. 1.3. 3  ramp_up 

This  routine  causes  the  ramp  to  be  raised.  The  appropriate  sound  is  made  of  the  ramp 
being  raised. 


1  Calls  1 

Function 

Where  Described 

sound  make  const  sound 

Section  2. 1.3. 1.2 

Table  2.3-274:  ramp_up  Information. 


2.3.6. 1.3.4  ramp_down 

This  routine  causes  the  ramp  to  be  lowered,  making  the  appropriate  sound. 


1  Calls  1 

Function 

Where  Described 

ssound  make  const  sound 

Section  2. 1.3. 1.2 

Table  2.3-275:  ramp_down  Information. 

2. 3. 6. 1.3. 5  ramp_idle 

This  routine  places  the  ramp  in  the  idle  state:  moving  neither  up  nor  down.  Any  sounds  of 
the  ramp  moving  are  ended. 


1  Calls  1 

Function 

Where  Described 

sound  make  const  sound 

Section  2. 1.3. 1.2 

Table  2.3-276:  ramp_idle  Information. 
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2. 3. 6. 1.3. 6  ramp_get_val 

This  routine  returns  the  ramp  status  value. 


i  Return  Values  1 

1  Return  Value 

Type 

Meaning 

REAL 

The  ramp  status 

Table  2.3-277;  ramp_get_va!  Information. 
2. 3. 6. 1.3. 7  ramp_down_status 


This  routine  returns  TRUE  if  the  ramp  is  being  lowered  and  FALSE  if  the  ramp  is  not 
being  lowered. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

TRUE 

int 

The  ramp  is  being  lowered 

FALSE 

int 

The  ramp  is  not  being  lowered 

Table  2.3-278:  ramp_up_status  Information. 
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2.3.6. 1.4  m2_launcher.c 

(./simn^rclease/src/vehicle/tn2/src/m2_launcher.c  [m2_launcher.c]) 

M2_launcher.c  maintains  the  model  of  the  launcher.  The  level  of  fidelity  required  for  the 
TOW  launcher  model  is  very  close  to  that  of  the  ramp.  This  file  tracks  whether  the 
launcher  is  moving,  in  the  up  position,  in  the  down  position,  or  somewhere  in  between.  It 
is  not  necessary  to  track  the  exact  position.  Thi  file  responds  to  commands  from  controls 
to  move  or  stop  the  launcher,  tracl^  the  time  required  to  raise  or  lower  the  launcher,  and 
makes  the  appropriate  sounds  associated  with  launcher  movement  and  stopping.  The  file 
tells  controls  when  a  stop  is  reached  and  provides  a  routine  to  return  the  launcher  status.  In 
addition,  this  frle  tells  the  network  and  the  munitions  management  when  the  launcher  is 
raised  or  lowered. 

Includes: 

"stdio.h" 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 

"libsound.h" 

"libnetwork.h" 

"m2_launcher.h" 

"m2_cntrl.h" 

"m2_sound_dfn.h" 

"m2_ammo.h" 

"m2_dtrain.h" 


Defines: 

DELTA_LAUNCHER 

THREE_MILES_PER_HOUR 

Declarations: 

launcher_val 

launcher_going_up 

launcher_going_down 

2 . 3 . 6 . 1 . 4 . 1  launch«r_i  ni  t_launcher_up 

This  routine  sets  the  launcher _yal  based  on  the  position  status  of  the  launcher  (either  up  or 
down). 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

UP  status 

int 

Standard 

Table  2.3-279:  launcher  init  launcher  Information. 
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2.3.60.1.4.2  launcher  simul 


This  RButine  is  called  on  a  tick  by  tick  basis  to  provide  the  launcher  simulation.  The 
launcher  position  during  the  last  tick  is  checked.  If  the  launcher  is  going  up,  the  sound  of 
the  laumcher  stopping  in  the  up  position  is  made;  if  the  launcher  is  going  down,  the  sound 
of  the  Ikuncher  stopping  in  the  ^wn  position  is  made.  The  network  and  ammo  modules 
are  notified  of  the  launcher  position. 


1  Internal  Variables  | 

1  Internal  Variable 

Where  Tvpedef  Declared 

Itemp 

REAL 

Sim  types. h 

1  Calls  1 

Functi^on 

Where  Described 

sound  {make  const  sound 

Section  2. 1.3.1 .2 

controteE_gunner_towJaunch 
er  off 

Section  2.3.2 

ammo  ttow  launcher  off 

Section  2.3.5.1.43 

network  tow  launcher  down 

Section  2.1.1.3.1.67.2 

controlt$_gunner_towJaunch 
er  on 

Section  2.3.2 

ammo  stow  launcher  on 

Section  2.3.5.1.42 

network,  tow  launcher  up 

Section  2.1.1.3.1.67.1 

Table  2.3-280:  Iauncher_simul  Information. 
2.3.6. 1.4.3  launcher_up 


This  nautine  causes  the  launcher  to  be  raised  if  the  vehicle  speed  is  less  than  3  mph.  The 
apprc^^ate  sound  is  made  of  the  launcher  being  raised. 


1  Calls  1 

Funct^ton 

Where  Described 

drivetrain  get  vehicle  speed 

Section  2.3. 6. 2.4. 8 

sound  make  const  sound 

Section  2.1. 3.1. 2 

Table  2.3-281:  launcher_up  Information. 


2. 3. 6. 1.4. 4  launcher_down 

This  ir:>utine  causes  the  launcher  to  be  lowered,  making  the  appropriate  sound. 


1  Calls  1 

Function 

Where  Described 

ssounri  make  const  sound 

Section  2. 1.3.1. 2 

Table  2.3-282:  launchcr  down  Information. 
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2. 3. 6. 1.4. 5  launcher_idle 

This  routine  places  the  launcher  in  the  idle  state:  moving  neither  up  nor  down.  Any 
sounds  of  the  launcher  moving  are  ended. 


1  Calls  1 

Function 

Where  Described 

sound  make  const  sound 

Section  2.1. 3.1. 2 

Table  2.3-283:  launcher_idle  Information. 
2. 3. 6. 1.4. 6  launcher_get_val 

This  routine  returns  the  launcher  status  value. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

launcher_val 

REAL 

The  launcher  status 

Table  2.3-284:  launcher_get_val  Information. 

2. 3. 6. 1.4. 7  launcher_up_status 

This  routine  returns  TRUE  if  the  laucher  is  being  raised  and  FALSE  if  the  kuncher  is  not 
being  raised. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

TRUE 

int 

The  launcher  is  going  up 

FALSE 

int 

The  launcher  is  not  going  up 

Table  2.3-285:  launcher_up_status  Information. 
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2. 3. 6. 2  M2  Propulsion  Simulation 

The  CSU's  which  provide  the  simulation  routines  are  as  follows: 

m2_ptrain.c 

m2_trans.c 

m2_cntrllr.c 

m2_dirain.c 

m2_engine.c 

in2_en^ail.c 


2. 3. 6. 2.1  m2_ptrain.c 

(./simnet/release/src/vehicle/m2/src/m2_ptrain.c  [m2_ptrain.c]) 

This  module  controls  the  overall  simulation  of  the  powertrain,  ground  dynamics  and 
kinematics.  The  simulation  routine  "powertrain_simul()"  is  called  from  m2_main.c. 

2. 3. 6. 2. 1.1  powertrain_init 

This  routine  is  called  to  initialize  the  elements  of  the  M2  powertrain:  the  engine,  the 
controller,  the  tranmission,  the  drivetrain,  and  the  odometer. 


1  Calls  1 

Function 

Where  Described 

engine  init 

Section  2.3.6.2.5.25 

controller  init 

Section  2.3.6.2.3.1 

transmission  init 

Section  2.3.6.2.2.3 

drivetrain  init 

Section  2.3.6.2.4.27 

odometer  init 

Section  2.3.2.3.4.1 

Table  2.3-286:  powertrain_init  Information. 

2. 3. 6. 2. 1.2  powertrain_simul 

This  routine  is  called  on  a  tick  by  tick  basis  in  order  to  provide  the  powertrain  simulation. 
The  engine,  the  controller,  the  transmission,  the  drivetrain,  and  the  odometer  module 
simulations  are  called  from  this  routine. 


1  Calls  1 

Function 

Where  Described 

engine  simul 

Section  2.3. 6.2.5. 1 

controller  simul 

Section  2.3.6.2.3.2 

transmission  simul 

Section  2.3.6.2.2.4 

drivetrain  simul 

Section  2.3. 6. 2.4.2 

odometer  simul 

Section  2.3.2.3.4.2 

Table  2.3-287:  powertrain  simul  Information, 
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2. 3. 6. 2. 2  in2_trans.c 

(./simnet/release/src/vehicle/m2/src/tn2_trans.c  [m2_trans.c]) 


The  HMPT-500  Continuously  Variable  Ratio  Transmission  is  modeled  in  these  routine  as 
two  positive  displacement  fluid  pumps  coupled  to  the  engine  via  two  epicyclic  gear  trains. 
There  are  three  forward  ranges  and  one  reverse  range.  Transmission  oil  leak,  and  major 
failure  are  simulated.  The  simulation  routines  are  called  from  m2_ptrain.c. 


Includes: 

"stdio.h" 

"sim_types.h" 

"sim_dfns.h" 

"sim_macros.h" 

"m2_cons.h" 

"m2_engine.h" 

m2_cntrllr.h" 

"m2_trans.h" 

"m2_dtrain.h" 


"m2_sound.h" 

"m2_main.h" 

"libkin.h" 

"libhulLh" 

"libsound.h" 

"libfail.h" 

"failure.h" 


Declarations: 
pump 
trans 
Q_coeef 
T_coeff 
fiLQO 
fit  TO 
firQ  initO 
fit"Tjnit() 
leak_timer 
mile_conter 
last_left_p 
last_right_p 

Defines: 

fit_R() 

fit_D() 

TEN_MIN_OF_TICKS 


2 . 3 . 6 . 2 . 2 . 1  transmissi  on_break_transniission 

If  the  transmission  status  is  NORMAL,  this  routine  causes  the  oil  temperature  to  become 
high  and  the  oil  pressure  to  become  low,  resulting  in  a  major  transmission  failure. 


1  Calls  1 

Function 

Where  Described 

controls_transmission_oil_te 
mperature  hiah 

Section  2.3.2 

controls  oil  pressure  low 

Section  2.3.2 

Table  2.3>288:  transmission  break  transmission  Information. 
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2 . 3 . 6 . 2 .2.2  transinission_replace_transmission 

This  routine  ftspairs  the  transmission,  causing  the  oil  temperature  and  oil  pressure  to 
become  nocoosstl. 


1  Calls  1 

Function 

Where  Described 

controls_transimission_oiLte 
moerature  ncnrmial 

Section  2.3.2 

controls_trans»mission_oil_pre 
ssure  normal 

Section  2.3.2 

TaMe  2.3-289:  transmission_replace_transmission  Information. 
2. 3. 6. 2. 2.3  transniission_init 

This  routine  unitializes  the  transmission  module,  including  the  load  torque,  the  status, 
timers,  counters,  and  the  failures. 


1  Calls  1 

Function 

Where  Described 

fit  Q  init 

Section  2.3.6.2.2.7 

fit  T  init 

Section  2.3.6.2.2.8 

fail  init  failure 

Section  2.5.4.11.2 

Table  2.3-290:  transmission  init  Information. 
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2. 3. 6. 2. 2. 4  transinission_simul 

This  routine  is  called  on  a  tick  by  tick  basis  to  simulate  the  transmission.  The  left  and  right 
stroke,  the  engine  speed,  the  shaft  speeds,  the  flow  rate  and  fluid  resistance,  and  the 
failuares  are  noodeled.  The  transmission  pressures  and  hydraulic  loads  are  calculated.  The 
load  to  engine  is  caluclated  for  the  current  gear  (mechanical  loads  are  proportional  to 
hydraulic  loads).  The  pressure  limits  are  calculated  after  the  loads  to  the  engine.  The 
torques  £q)plied  to  the  shaft  are  calculated. 


1  Internal  Variables  | 

Internal  Variable 

Where  Tvpedef  Declared 

left  stroke 

REAL 

Sim  tvpes.h 

right  stroke 

REAL 

Sim  types.h 

a  left  stroke 

REAL 

Sim  types.h 

a  right  stroke 

REAL 

Sim  types.h 

e  speed 

REAL 

Sim  types.h 

left  shaft  speed 

REAL 

Sim  types.h 

right  shaft  speed 

REAL 

Sim  types.h 

1  Errors  I 

Error  Name 

Reason  for  Error 

Transmission  simul 

Unknown  gear  setting 

1  Calls  1 

Function 

Where  Described 

controller  stroke  left 

Section  2.3.6.2.3.6 

controller  stroke  right 

Section  2.3.6.2.3.7 

engine  speed 

Section  2.3.6.2.5.11 

drivetrain  left  omega 

Section  2.3.6.2.4.9 

drivetrain  right  omega 

Section  2.3.6.2.4.10 

controller  gear 

Section  2.3.6.2.3.8 

fit  D 

Section 

fit  R 

Section 

fit  Q 

Section  2.3.6.2.2.7 

fit  T 

Section  2.3.6.2.2.8 

odometer  mile  counter 

Section  2.3.2.3  4.8 

controls_transmission_oiLte 
mperature  high 

Section  2.3.2 

transmission_breakJransmiss 

ion 

Section  2.3.6.2.2.1 

Table  2.3-291:  transinission_simuI  Information. 

2.3.6.2.2.5  m_TJnit 

This  routine  initializes  the  coefficients  for  the  torque  fit. 

2. 3. 6. 2. 2. 6  fit_Q_init 

This  routine  initializes  the  coefficients  for  the  flow  rate  fit. 
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2. 3.6.2. 2.7  rit_Q 


This  routine  models  the  flow  rate  fit  using  the  flow  rate  coefficients  and  current  gear, 
engine  speed,  and  both  shaft  speeds.  Parameters  are  represented  as  follows: 


gear  --  The  current  gear 

e  speed  -  The  engine  speed 

sJi^_speed  -  This  shaft  sp^ 

other_shcfi_speed  -  Other  shaft  speed 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

aear 

int 

Standard 

e  speed 

REAL 

Sim  types.h 

shaft  speed 

REAL 

Sim  types.h 

other  shaft  speed 

REAL 

sim  types.h 

Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

coeff  P 

pointer  to  REAL 

sim  types.h 

Q 

REAL 

sim  types.h 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

Q 

REAL 

The  flow  rate  fit 

Table  2.3-292:  fit_Q  Information. 
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2.3.6. 2. 2. 8  fit_T 

This  routine  models  the  torque  output  fit  using  the  torque  coefficients  and  current  gear,  and 
the  pressure  in  the  two  pump  motors.  Parameters  are  represented  as  follows: 

gear  -  The  current  gear 

timJP  --  The  pressure  in  this  pump  motor 

'  *her_P  -  The  pressure  in  the  other  pump  motor 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

gear 

int 

Standard 

this  P 

REAL 

Sim  tvpes.h 

other  P 

REAL 

Sim  types. h 

Internal  Variables 

Internal  Variable 

Tvoe 

Where  Typedef  Declared 

T 

REAL 

Sim  tvpes.h 

coeef  P 

pointer  to  REAL 

Sim  tvpes.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

T 

REAL 

The  torque  output  fit 

Table  2.3-293:  fit  T  Information. 


2. 3. 6. 2. 2. 9 


transmission_load_torque 


This  routine  returns  the  transmission  load  torque. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

trans.loadjorque 

REAL 

The  transmission  load  torque 

Table  2.3-294:  transmission_load_torque  Information. 
2.3.6.2.2.10  transmission_torque_left 

This  routine  returns  the  the  torque  applied  to  the  left  side  of  the  transmission. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

trans.left.T 

REAL 

The  left  side  of  the 
transmission's  torque  value 

Table  2.3-295:  transmission_torque_left  Information. 
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2.3.6.2.2.11  transmission_torque_right 

This  routine  returns  the  torque  applied  to  the  right  side  of  the  transmission. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

trans.loadjorque 

REAL 

The  right  side  of  the 
transmission's  torque  value 

Table  2.3*296:  transmission_load_torque  Information. 
2.3.6.2.2.12  transmission_oiMeak 

This  routine  models  an  oil  leak  in  the  transmission,  setting  the  leak  status  to  ISF AILED. 
The  controls  of  transmission  oil  pressure  are  set  to  low  and  the  odometer  is  reset. 


1  Calls  1 

Function 

Where  Described 

controls_transmission_oil_pre 
ssure  low 

Section  2.3.2 

odometer  mile  counter  rese 
t 

Section  2.3.2.3  4.7 

Table  2.3*297:  transmission_oil_leak  Information. 
2.3.6.2.2.13  transmission_repai r_oil_leak 

This  routine  causes  the  repair  of  a  transmission  oil  leak,  setting  the  leak  status  to 
NORMAL.  The  transmission  oil  temperature  and  pressure  controls  are  set  to  normal. 


1  Calls  1 

Function 

Where  Described 

controls_transmission_oil_te 
mperature  normal 

Section  2.3.2 

controls_transmission_oiljpre 
ssure  normal 

Section  2.3.2 

Table  2.3*298:  transmission_repair_oil_leak  Information. 

2  3.6.2.2.14  Debugging  tools 

The  following  routines  are  used  for  printing  tranmission  status  reports  during  debugging: 

tranmission_dump() 

tranmission_banner() 

tranmission_data_titie() 

tranmission~data_banner() 

tranmissiondatadumpO 
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2. 3. 6. 2. 3  in2_cntrllr.c 

( /simnel/release/src/vehicle/m2/src/m2_cntrllr.c  [m2_cntrllr.c]) 


Includes: 

"stdio.h" 

"sim_types.h" 

"sim_(tfns.h" 

"sim_macros.h" 

"m2_engine.h" 

"in2_cntrllr.h" 

"m2_trans.h" 

"m2_cons.h" 

"m2_launcher.h" 

In  the  following  header  structure,  cntrllr,  gear  is  the  gear  the  transmission  is  in,  gear  set  is 
the  gear  the  transmission  is  set  to,  upshijft  delay  is  the  number  of  ticks  to  delay  upshifdng 
from  1st  to  2nd  after  a  downshift,  s  cms  is  the  steering-commanded  input,  cam  is  the  cam 
position,  throttle  is  the  throtde  value  to  the  engine,  speed  ref  is  the  reference  speed  in  rad/s, 
and  speed  error  is  speedjrefromws  actual  speed  in  rad/s. 


Item 

Type 

Where  Type  Defined 

dear 

int 

Standard 

aear  set 

int 

Standard 

UDShift  delay 

int 

Standard 

s  cmd 

REAL 

sim  types. h 

cam 

REAL 

Sim  types. h 

throttle 

REAL 

Sim  types. h 

speed  ref 

REAL 

Sim  types.h 

speed  error 

REAL 

Sim  types.h 

Table  2.3-299:  cntrllr  Structure  Definition 

In  the  following  header  structure,  stroke,  left  is  the  left  stroke  value,  right  is  the  right  stroke 
value,  and  val  is  the  stroke  value  from  the  control  cam. 


Item 

Where  Type  Defined 

left 

REAL 

sim_  types.h 

riaht 

REAL 

sim  types.h 

val 

REAL 

Sim  types.h 

Table  2.3-300:  stroke  Structure  Definition 

In  the  following  header  structure,  steer,  val  is  the  steering  val  =  bar**2,  gov  input  is  the 
steering  governor  input,  and  mod  is  the  steering  modifier  term. 


Item 

Where  Type  Defined 

val 

REAL 

sim  types.h 

aov  input 

REAL 

sim  types.h 

mod 

REAL 

sim.  types.h 

Table  2.3-301:  steer  Structure  Definition 
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In  the  following  header  structure,  cam_cons[51,  min  cam  is  the  minimum  cam  position  for 
gear  setting,  max  cam  is  the  maximum  cam  position  for  gear  setting,  shift  up  is  the  up 
shift  cam  position,  shift  dn  is  the  down  shift  cam  position,  mins  is  the  minimum  stroke, 
maxs  is  the  maximum  stroke,  and  Kg  is  the  error  gain  for  this  gear. 


Item 

Where  Type  Defined 

min  cam 

REAL 

Sim  tvpes.h 

max  cam 

REAL 

Sim  tvpes.h 

shift  up 

REAL 

sim  tvpes.h 

shift  dn 

REAL 

sim  tvpes.h 

mins 

REAL 

sim  tvpes.h 

maxs 

REAL 

sim  tvpes.h 

Kfl _ 

REAL 

sim  tvpes.h 

Table  2.3-302:  cam  cons[5]  Structure  Definition 


Defines! 

steer_gov(x)  ((REAL)  0.722  *(((REAL)  1 .482  -  (x))/((REAL)  1 .07  +  (x)))) 

Procedure  declarations: 
shift_check() 
stroke_calc() 
fit_sp^d_ref() 


2. 3. 6. 2. 3.1  controller  init 


This  routine  initializes  the  transmission  controller. 


2. 3. 6. 2. 3. 2  controller_simul 

This  routine  provides  the  tick  by  tick  simulation  of  the  transmission  controller. 


Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

temp 

REAL 

sim  tvpes.h 

1  Calls  1 

Function 

Where  Described 

fit  speed  ref 

Section  2.3.6.2.3.3 

enaine  speed 

Section  2.3.6.2.5.11 

max 

sim  macros.h 

min 

sim  macros.h 

launcher  up  status 

Section  2.3  6.1. 4.7 

shift  check 

Section  2.3  6.2.3.4 

stroke  calc 

Section  2.3  6.2.3.5 

Table  2.3-303:  controller  simul  Information. 
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2. 3. 6. 2. 3. 3  fit_speeed_ref 

This  routine  calculates  the  reference  speed  from  the  throttle  value  and  the  cam  value. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

throttle 

REAL 

Sim  types. h 

main  cam 

REAL 

Sim  types. h 

1  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

speed  ref 

REAL 

Sim  types. h 

max  throttle 

REAL 

Sim  types. h 

min  throttle 

REAL 

Sim  types. h 

1  Return  Values  1 

Return  Value 

Type 

Meaninp 

M2  IDLE  REF  +  speed  ref  * 
M2  REF  SPEED  SLOPE 

REAL 

The  reference  speed 

1  Calls  1 

Function 

Where  Described 

min 

Sim  macros.h 

max 

Sim  macros.h 

Table  2.3-304:  fit_speeed_ref  Information. 


2. 3. 6. 2. 3. 4  shift_check 

This  routine  shifts  the  gears  if  a  shift  is  required,  making  sure  the  vehicle  is  in  the  correct 
gear.  Drive  is  tlie  only  gear  that  shifting  is  allowed. 
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2.3. 6. 2. 3. 5  stroke_calc 

Hms  routine  calculates  the  stroke  and  sets  the  appropriate  stroke  value  holders. 


1  Internal  Variables  I 

Infternal  Variable 

Where  Typedef  Declared 

tenqp 

REAL 

sim  types. h 

1  Errors  I 

Emor  Name 

Reason  for  Error 

strolke  calc.  Unknown  gear ... 

The  element  cntrllr.aear  has  an  unexpected  value. 

1  Calls  1 

Function 

Where  Described 

error  printf 

Section  2.6.4.14.1 

min 

sim  macros.h 

m£Di< 

Sim  macros.h 

abs 

sim  macros.h 

stetar  aov 

Section  2.3.2 

Table  2.3-305:  stroke  calc  Information. 


2  ..3 . 6 . 2 . 3 . 6  cont  roller_st  rokc_left 

Thus  routine  returns  the  value  of  the  left  stroke. 


1  Return  Values  1 

Rectum  Value 

Type 

Meaning 

stroke. left 

REAL 

The  value  of  the  left  stroke. 

Table  2.3-306:  controller_stroke_left 

Information. 

2  ...3 . 6 . 2 . 3 . 7  controller_stroke_right 

Tlrtis  routine  returns  the  value  of  the  right  stroke. 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

stroke. right 

REAL 

The  value  of  the  right  stroke 

Table  2.3’?07:  controller_stroke_right  Information. 
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2. 3. 6. 2. 3. 8  controller_gear 

This  routine  returns  the  transmission  controller  gear  value. 


1  Return  Values  I 

Return  Value 

Meanina 

cntrllr.aear 

int 

The  controller  gear  value 

Table  2.3-308:  controller_gear  Information. 


2. 3. 6. 2. 3. 9  controller_neutraI 

This  routine  sets  the  transmission  gear  value  to  neutral  and  disengages  the  start  of  the 
engine. 


1  Calls  1 

Function 

Where  Described 

engine  out  of  start 

Section  2.3.6.2.5.3 

Table  2.3-309:  controller  neutral  Information. 


2.3.6.2.3.10  controller_pivot 

The  routine  sets  the  transmission  gear  value  to  neutral. 

2.3.6.2.3.11  controller_<lrive 

This  routine  places  the  gear  setting  in  drive  position. 

2.3.6.2.3.12  controller_low 

This  routine  places  the  transmission  gear  setting  in  low  speed. 

2.3.6.2.3.13  controller_reverse 

This  routine  places  the  transmission  gear  setting  in  reverse. 


2.3.6.2.3.14  controller_start 

This  routine  sets  the  transmission  gear  value  to  neutral  and  starts  the  engine. 


1  Calls  1 

Function 

Where  Described 

engine  start 

Section  2.3.6.2.5.2 

Table  2.3-310:  controller  start  Information. 
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2.3.6.2.3.15  controller_set_throttle 

This  routine  sets  the  throttle  to  the  value  passed  in  val. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

val 

REAL 

Sim  tvoes.h 

Table  2.3-311:  controller  set  throttle  Information. 


2.3.6.2.3.16  cont roller_set_steer ing_ba r 


This  routine  sets  the  transmission  steering  to  the  value  passed  in  val. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

val 

REAL 

Sim  tvoes.h 

1  Calls  1 

Function 

Where  Described 

abs 

Sim  macros.h 

Table  2.3-312:  controller_set_steering_bar  Information. 


2.3.6.2.3.17  cntrllr_dump 

This  routine  prints  the  values  of  stroke,  left  stroke,  right  stroke,  cam,  and  gear. 


2.3.6.2.3.18  cntrilr_banner 

This  routine  prints  the  banner  heading  for  the  controller  dump. 

2.3.6.2.3.19  cntrllr_data_title 

This  routine  prints  the  data  title. 

2.3.6.2.3.20  cntrllr_data_banncr 

This  routine  prints  the  data  banner. 


2.3.6.2.3.21  cntrilr_data_dump 

This  routine  prints  out  the  values  of  the  left  stroke  and  the  right  stroke. 


856 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


2. 3. 6. 2. 4  m2_dtrain.c 

(./sinm^release/src/vehicle/ni2/src/ni2_dtrain.c  [m2_dtrain.c]) 

Track  and  hull  dynamics  are  simulated  in  this  file.  The  transmission  puts  out  torque  to  the 
tracks  which  accelerate  and  rotate  the  tank.  Brakes  are  also  accounted  for  in  this  file. 
Failure  of  service  brake,  pftrking  brake,  and  tracks  are  maintained.  These  simulation 
routines  are  called  from  m2_ptrain.c. 

This  file  contains  variables,  functions,  arrays,  and  stmctures.  The  variables  are  defined  and 
initialized  as  shown  in  the  next  table. 


1  Variable 

Type 

Where  Type 
Defined 

Initial  Value 

REAL 

sim_types.h 

100000.0 

REAL 

simjypes.h 

N/A 

soil  type 

int 

Standard 

N/A 

track  speed  fraction 

REAL 

Sim  types. h 

N/A 

Table  2.3-313:  m2_dtrain.c  Variable  Definitions. 

The  dtrain_status  structure  is  described  below.  It  gives  the  status  of  the  drivetrain 
components. 


item 

Where  Type  Defined 

slip  state 

int 

Standard 

left  track 

int 

Standard 

right  track 

int 

Standard 

brake 

int 

Standard 

p  brake 

int 

Standard 

parking  brake  on 

int 

Standard 

Table  2.3-314:  dtrain  status  Structure  Definition. 
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The  dtrain  structure  is  described  below. 


Item 

Type 

Where  Type  Defined 

udotr4l 

REAL 

Sim  types. h 

ur4i 

REAL 

Sim  types.h 

FO 

REAL 

Sim  types.h 

friction  FO 

REAL 

Sim  types.h 

T1 

REAL 

Sim  types.h 

friction  T1 

REAL 

Sim  types.h 

T2 

REAL 

Sim  types.h 

friction  T2 

REAL 

Sim  types.h 

T3 

REAL 

friction  T3 

REAL 

Sim.  types.h 

forward  diff 

REAL 

Sim  types.h 

Ditch  sin 

REAL 

Sim  types.h 

cant  sin 

REAL 

Sim  types.h 

traction  force 

REAL 

Sim  types.h 

brake  factor 

REAL 

Sim  types.h 

Table  2.3-315:  dtrain  Structure  Definition. 

The  track_fnction[6]  and  rotational_fTiction[6]  static  structures  are  described  below. 


Item 

Where  Type  Defined 

Staticf 

REAL 

Sim  types.h 

Viscous 

REAL 

Sim  types.h 

Table  2.3-316:  track_friction[6]  and  rotational_friction[6]  Structure 

Definition. 


Slip  flags  are  defined  as  follows: 


Constant 

Value 

NO  SLIP 

0 

SLIP 

1 

Table  2.3-317:  ni2_dtrain.c  Constant  Definitions. 
The  arrays  are  defined  and  initialized  as  shown  in  the  next  table. 


Array 

Where  Type 
Defined 

Initial  Values 

rear  wheel 

VECTOR 

left  wheel 

VECTOR 

sim  types.h 

1-1.75,  4.5,  0.01 

right  wheel 

VECTOR 

11.75,  4.5,  0.0) 

Table  2.3-318:  ni2_dtrain.c  Array  Definitions. 

These  parameters  are  used  to  initialize  the  suspension  library  at  run -time. 

I  Parameter  lvalue  ~ 


] 
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ROT  WN  -  rot  suspension  natural  frea  (rad) 

(REAL)2.0 

ROT_ZETA  --  rotational  suspension  damping 
ratio 

(REAL)0.3 

SIDE  WN  -  side  suspension  natural  frea  (rad) 

(REAL)3.5 

SIDE  ZETA  --  side  suspension  dampina  ratio 

(REAL)0.2 

LEVER  ARM  -Meters 

(REAL)0.003 

ANGLE  LIM  - -9  deorees  .7  m  bv  4.5  m 

(REAL)0.156 

GUN  FORCE  -  Force  of  firina  the  aun 

(READO.OI 

M2_NO_SLIP_LUMPED_MASS 

(M2  MASS+2.0*M2  TRACK  MASS+(M2 
WHEEL  INERTIA  0*2.0)/(M2  WHEEL 
RADIUS*M2  WHEEL  RADIUS)) 

M2_N0_SLIP_LUMPEDJNERTIA 

(M2  INERTIA  2+2.0*M2  WHEEL  INERTIA 
2+M2  TRACK  MASS*M2  WIDTH*M2 
WIDTH*0.5+(M2  WIDTH*M2  WIDTH*M2 
WHEEL  INERTIA  0)/(2.0*M2  WHEEL 
RADIUS*M2  WHEEL  RADIUS)) 

M2  SLIP  LUMPED  VEHICLE  MASS 

(M2  MASS+2.0*M2  TRACK  MASS) 

MAX  TRACK  CANT  SIN  -SIN(22 

DEGREES)  =  40% 

0.374606 

TRACK  SELF  REPAIR  TIME  -  minutes 

30 

Table  2.3*319:  m2  dtrain.c  Run-time  Initialization  Parameters. 


2. 3. 6. 2. 4.1  check_for_thrown_track 

This  routine  checks  for  thrown  tracks.  Each  time  one  is  found,  the  fail_break_system 
routine  is  called. 


1  Calls  1 

Function 

Where  Described 

fail  break  system 

Section  2.5.4.8.1 

Table  2.3-320:  check_for_thrown_track  Information. 
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2. 3. 6. 2. 4. 2  drivetrain  simul 


This  routine  simulates  vehicle  drive  train  functions. 


1  Calls  1 

Function 

Where  Described 

transmission  torque  left 

Section  2.3.6.2.2.10 

transmission  torque  riqht 

Section  2.3.6.2.2.11 

terrain  qet  terrain  type 

Section  2.5.11.3.1 

kinematics  pitch  sin 

Section  2.5.8.5.1 

kinematics  cant  sin 

Section  2.5.8.5.3 

check  for  thrown  track 

Section  2.3.6.2.4.1 

rotational  friction  factor 

Section  2.3.6.2.4.3 

compute  traction  force 

Section  2.3.6  2.4.4 

check  forward  coiiision 

Section  2.3.6.2.4.6 

check  side  coiiision 

Section  2.3.6.2.4.7 

check  for  siip 

Section  2.3.6.2.4.5 

suspension  acceieration  is 

Section  2.5.6.3.1 

sound  of  tracks 

Section  2.1.3.3.13 

meter  speed  set 

Section  2.3.2.3.3 

kinematics  move  vehicle 

Section  2.5.8.7.1 

kinematics  turn  vehicle 

Section  2.5.8.11.1 

network  set  dust  cloud 

Section  2.1.1.3.1.12.1 

tracks  qet  dust  cloud 

Section  2.3.7.2.1 

Table  2.3*321:  drivetrain  simul. 


2. 3. 6. 2. 4. 3  rotational_friction_factor 

This  routine  calculates  the  rotational  friction  factor  from  vehicle  speed  (v)  and  angular 
velocety  (w). 


1  Parameters 

Parameters 

Type 

Where  Typedef  Declared 

V 

REAL 

sim  types. h 

w 

REAL 

simjypes.h 

1  ReturnValues 

Return  Value 

Meaning 

factor 

REAL 

Rotational  friction  factor. 

Table  2.3-322:  rotational  friction  factor. 
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2 . 3 . 6 . 2 . 4 . 4  compute_traction_force 

This  routine  calculates  the  traction  force  from  the  vehicle  pitch,  vehicle  state,  and  soil  type. 


1  Parameters  I 

Parameters 

Where  Typedef  Declared 

pitch  sin 

REAL 

Sim  types.h 

state 

int 

Standard 

soil type 

int 

Standard 

1  ReturnValues  1 

Return  Value 

Meanina 

traction  force 

REAL 

Traction  force. 

Table  2.3-323:  compute_traction_force. 


2. 3. 6. 2. 4. 5  check_for_slip 

This  routine  determines  whether  the  vehicle  drive  tracks  are  slipping  or  not  given  the 
traction  force  and  soil  type. 


1  Parameters  I 

■  Parameters 

Where  Typedef  Declared 

1  traction  force 

REAL 

Sim  types.h 

1  ReturnValues  1 

Return  Value 

Type 

Meanina 

SLIP 

int 

Drive  tracks  are  slipping. 

NO  SLIP 

int 

Drive  tracks  are  not  slipping. 

Table  2.3-324: 


check_for_slip. 
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2. 3. 6. 2. 4. 6  check  forward  collision 


This  routine  determines  whether  a  collision  has  occurred  while  traveling  backwards  or 
forwards,  given  the  velocety  v. 


1  Parameters  I 

Parameters 

Tvoe 

Where  Tvoedef  Declared 

v 

REAL 

Sim  tvoes.h 

1  ReturnVaiues  I 

■  Return  Value 

Meanina 

REAL 

Collision  has  occurred. 

Iv 

REAL 

No  collision  has  occurred. 

1  Calls  1 

Function 

Where  Described 

collision  rear  collision 

Section  2.5.10.4.3 

collision  left  collision 

Section  2.5.10.4.1 

collision  riaht  collision 

Section  2.5.10.4.2 

Table  2.3-325:  check  forward  collision. 


2. 3. 6. 2. 4. 7  check  side  collision 


This  routine  determines  whether  a  side  collision  has  occurred  while  the  vehicle  is  turning. 


1  Parameters  I 

Parameters 

Tyoe 

Where  Typedef  Declared 

w 

REAL 

sim.  types. h 

1  ReturnVaiues  I 

Return  Value 

Type 

0.0 

REAL 

Collision  has  occurred. 

w 

REAL 

No  collision  has  occurred. 

1  Calls  1 

Function 

Where  Described 

collision  left  collision 

Section  2.5.10.1.1 

collision  riaht  collision 

Section  2.5.10.1.2 

Table  2.3-326:  check  side  collision. 
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2 . 3 . 6. 2 .4 .8  drivetrain_get_vehicle_speed 


This  routine  returns  the  vehicle  speed. 


1  ReturnValues  1 

Return  Value 

Type 

Meanlnq 

dtrain.ufOl 

REAL 

Vehicle  speed. 

Table  2.3-327:  drivetrain_get_vehicle_speed. 


2 . 3 . 6 . 2 . 4 . 9  drivetrainJeft_omega 


This  routine  returns  the  angular  velocety  of  the  left  track. 


1  ReturnValues  1 

Return  Value 

Meanina 

dtrain.ur21 

REAL 

annular  velocety  of  left  track 

Table  2.3-328:  drivetrain_left_oinega. 


2.3.6.2.4.10  drive!  rain_right_omega 


This  routine  returns  the  angular  velocety  of  the  right  track. 


1  ReturnValues  1 

Return  Value 

Meanina 

dtrain.uFSI 

REAL 

annular  velocety  of  rinht  track 

Table  2.3-329:  drivetrain_right_omega. 


2.3.6.2.4.11  drivetrain  set  brake 


This  routine  sets  the  brake  factor  to  val  if  the  parking  brake  is  off  and  the  service  brake  has 
not  failed,  val  is  a  control  setting  from  the  br^e  pedal. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

val 

REAL 

Sim  types. h 

Table  2.3-330:  drivetrain  set  brake. 
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2.3.6.2.4.12  drivetrain_parking_brake_set 

This  routine  sets  the  parking  brake  on  and  nrakes  the  sound  of  the  brake  being  set. 


1  Calls  1 

Function 

Where  Described 

sound  make  const  sound 

Section  2. 1.3.1. 2 

Table  2.3>331:  drivetrain_parking_brake_set. 


2.3.6.2.4.13  dri  vetrain_parking_brake_release 

This  routine  sets  the  parking  brake  off  and  the  brake  factor  to  0  and  makes  the  sound  of  the 
parking  brake  being  released. 


1  Calls  1 

Function 

Where  Described 

sound  make  const  sound 

Section  2. 1.3.1. 2 

Table  2.3-332:  drivetrain_parking_brake_release. 


2.3.6.2.4.14  drivetrain_service_brake_failure 
This  routine  causes  the  service  brake  to  fail. 

2.3.6.2.4.15  drivetrain_repair_servlce_brake 
This  routine  repairs  the  service  brake. 

2.3.6.2.4.16  dri  vet  rain_parking__brake_failure 
This  routine  fails  the  parking  brake  and  sets  the  brake  factor  to  0. 


1  Calls  1 

Function 

Where  Described 

sound  make  const  sound 

Section  2. 1.3.1. 2 

Table  2.3-333:  drlvetrain_parking_brake_failure. 


2.3.6.2.4.17  drivetrain_repair_parking_brake 

This  routine  repairs  the  parking  brake  and  sets  it  on  with  a  brake  factor  of  1 . 
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2.3.6.2.4.18  dri  vetrain_throw_right_track 
This  routine  fails  the  right  drivetrain  track. 


1  Calls  1 

Function 

Where  Described 

biowheel  riaht  track  broken 

Section  2.5.10.10.2 

Table  2.3-334:  drivetrain_throw_right_track. 


2.3.6.2.4.19  drivet  rain_th  ro  w_left_track 

This  routine  fails  the  left  drivetrain  track. 


I  Calls  I 

Function 

Where  Described 

biowheel  left  track  broken 

Section  2.5.10.10.1 

Table  2.3-335:  drivetrain_throw_left_track. 


2.3.6.2.4.20  dri  vetrain_repair_thrown_tracks 

This  routine  repairs  both  the  left  and  right  drivetrain  tracks,  regardless  of  which,  if  any,  are 
broken. 


1  Calls  1 

Function 

Where  Described 

biowheel  repair  tracks 

Section  2.5.10.10.3 

Table  2.3-336:  drivetrain_repair_thrown_tracks. 


2.3.6.2.4.21  dunip_drivetrain_state 

This  routine  prints  the  status  of  the  drivetrain  brakes  and  tracks. 

2.3.6.2.4.22  drivetrain_data_title 
This  routine  prints  the  "dtrain"  header  for  debugging. 

2.3.6.2.4.23  drivetrain_data_banner 

This  routine  prints  the  column  headings  Wl,  Wr,  and  V  for  debugging. 

2.3.6.2.4.24  drivetrain_data_dump 

This  routine  prints  the  drivetrain  data  Wl,  Wr,  and  V  for  debugging. 
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2.3.6.2.4.25  drivetrain_banner 

This  routine  prints  the  column  headings  n,  Tr,  Wl,  Wr,  V,  and  Rot  for  debugging. 

2.3.6.2.4.26  drivetrain_dump 

This  routine  prints  the  drivetrain  data  Tl,  Tr,  Wl,  Wr,  V,  and  Rot  for  debugging. 


1  Calls  1 

Function 

Where  Described 

transmission  torque  ieft 

Section  2.3.6.2.2.10 

transmission  torque  riqht 

Section  2.3.6.2.2.11 

Table  2.3-337:  drivetrain_dump. 


2.3.6.2.4.27  drivetrain_init 
This  routine  initializes  the  drivetrain. 


1  Calls  1 

Function 

Where  Described 

biqwheel  veh  init 

Section  2.5.10 

suspension  params 

Section  2.5.6.5.1 

fail  init  failure 

Section  2.5.4.11.2 

'Table  2.3-338:  drivetrain  init  Information 
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2. 3. 6. 2. 5  m2_engine.c 

(./simn^release/srcA'ehicle/m2/src/m2_engine.c  [m2_engine.c]) 

The  Cummins  VTA-903-T  diesel  engine  is  simulated  in  this  module  by  parameterizing  a 
family  of  fourth  order  polynomial  torque  curves  based  on  throttle  position.  The  engine 
runs  its  own  dynamics  based  on  load  torque  from  the  transmission,  output  torque,  and 
engine  inertia.  The  simulation  routines  are  called  from  m2_ptrain.c. 

Includes: 

"stdio.h" 

"math.h" 

"sim_types.h" 

"sim_(tfns.h" 

"sim_macros.h" 

"m2_engfail.h" 

"libfaiLh" 

"failurc.h" 

"m2_trans.h" 

"m2_cons.h" 

"m2_cntrllr.h" 

"m2_sound.h" 

"ni2_fuelsys.h" 

"ni2_gages.h" 

"Ubsound.h" 


BBN  Systems  and  Technologies 


Vehicles  CSCl 


In  the  following  header  structure,  engine,  state  is  the  engine  state  (OFF,  CRANK,  RUN), 
start  delay  is  the  number  of  ticks  to  delay  starting,  fuel  supply  is  the  fuel  available  flag, 
start_state  is  the  engine  starting  states,  pressure  status  is  the  oil  pressure  (normal  or  low), 
coolant  status  is  the  coolant  temperature  (normal  or  high),  accessories  is  the  engine 
accessoiy  switch,  oil  jtressure  is  the  oil  pressure  (0  to  1()0  psi),  oil  temperature  and 
coolant  temperature  are  in  Farenheit,  speed  is  in  rad/sec,  accel  is  in  rad/sec**2,  torque  is  in 
kg-m**2/s£c**2,  power percent  is  the  power  percentage,  loadjorque  is  in  Newton- 
meters,  throttle  is  throttle  from  controls,^/  Jlow  is  in  gallons/hour,  inertia[5]  is  the 
inertia  term  for  each  gear,  engine  Jailure  is  the  engine  failure  flag,  and  starter  Jailure  is  the 
starter  failure  flag. 


Item 

Where  Type  Defined 

state 

int 

Standard 

start  delay 

int 

Standard 

fuel  supply 

int 

Standard 

start  state 

int 

Standard 

pressure  status 

int 

Standard 

coolant  status 

int 

Standard 

accessories 

int 

Standard 

oil  pressure 

REAL 

sim  types. h 

oil_  temperature 

REAL 

Sim  types. h 

coolant  temperature 

REAL 

Sim  types. h 

speed 

REAL 

sim  types. h 

accel 

REAL 

sim  types. h 

torque 

REAL 

sim  types. h 

power  percent 

REAL 

sim_  types. h 

load  torque 

REAL 

sim  types. h 

throttle 

REAL 

sim  types. h 

fuel  flow 

REAL 

sim  types. h 

inertiafSI 

REAL 

sim  types. h 

enqine  failure 

int 

Standard 

starter  failure 

int 

Standard 

Table  2.3-339:  engine  Structure  Definition 


Defines: 


Symbol 

Value 

ENGINE  OFF 

(int)-l 

ENGINE  CRANK 

(ini)  0 

ENGINE  RUN 

(int)  1 

STARTER  NO  CRANK 

(int)  - ) 

STARTER  CRANK 

(int)  0 

STARTER  START 

(int>  1 

HIGH  COOLANT  lEMP 

220.0 

LOW  OIL  PRESSURE 

4.5 

MAX  OVERHEAT  TICKS 

27000 

Procedure  declarations; 

fit_engine_torque( ) 
enginerunO 
enginecrankO 
engine  offO 
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int  declarations: 

overheat_ticks 


REAL  declarations: 

engine_speed_fi:action 

2. 3. 6. 2. 5.1  engine_simul 


This  routine  provides  the  engine  simulation  on  a  tick  by  tick  basis.  The  engine 
performance  is  simulated  in  the  di^erent  engine  states.  The  failure  timers  are  updated,  and 
the  fuel  supply  is  regulated. 


1  Errors  I 

Error  Name 

Reason  for  Error 

engine_simul,  Unknown  state 

The  element  engine.state  has  an  unexpected  value. 

Calls 

Function 

Where  Described 

controls_engine_oilj3ressure 

low 

Section  2.3.2 

engine  crank 

Section  2.3.6.2.5.17 

engine  run 

Section  2.3.6.2.5,16 

max 

Sim  macros.h 

gage  oil  temperature 

Section  2  3.2.3.2,2 

gage  coolant  temperature 

Section  2.3.2.3.2,3 

controls_coolant_temperature 

high 

Section  2.3.2 

controls_coolantJemperature 

normal 

Section  2.3.2 

engine  coolant  leak 

Section  2.3.6.2.6.1 

error  printf 

Section  2.6.4.14.1 

gage  oil  pressure 

Section  2.3.2.3.2.1 

meter  press  set 

Section  2.3.2.3.3.6 

meter  temp  set 

Section  2.3  2.3.3.5 

controls_engine_oil_pressure 

normal 

Section  2.3.2 

engine  failure  update 

Section  2.3.6.2.6.11 

fuel  set  flow 

Section  2.3. 5.2.5 

Table  2.3-340:  controller  simul  Information. 
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2. 3. 6. 2. 5. 2  engine_start 

This  routine  starts  the  engine  from  the  ENGINE_OFF  state,  and  performs  no  operation 
from  any  other  state. 


1  Errors  I 

Error  Name 

Reason  for  Error 

engine_start,  Unknown  state 

The  element  engine.state  has  an  unexpected  value. 

Calls 

Function 

Where  Described 

error  printf 

Section  2.6.4.14.1 

Table  2.3-341:  englne^start  Information. 


2. 3. 6. 2. 5. 3  engine_out_of__start 
This  routine  is  called  to  disengage  the  start. 


1  Calls  1 

Function 

Where  Described 

sound_of_engine_cranking_ 

stop 

Section  2.1.3.3.11 

sound  of  engine  stall 

Section  2.1.3.3.12 

Table  2.3-342:  engine_out_of_start  Information. 


2. 3. 6. 2. 5. 4  engine_accessory_on 

This  routine  sets  the  engine  accessories  and  engine  accessory  controls. 


1  Calls  1 

Function 

Where  Described 

controls_engine_accessory_ 

on 

Section  2.3.2 

Table  2.3-343:  engine  accessory  on  Information. 
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2. 3. 6. 2. 5. 5  engine_accessory_off 

This  routine  turns  off  engine  accessories  and  unsets  the  engine  accessory  controls. 


1  caiis  1 

Function 

Where  Described 

controls  engine  accessory 
off 

Section  2.3.2 

Table  2.3-344:  engine_accessory_off  Information. 


2. 3. 6. 2. 5. 6  engine_fail 

This  routine  causes  the  engine  to  fail. 

2. 3. 6. 2. 5. 7  engine_fix 

This  routine  repairs  the  engine. 

2. 3. 6. 2. 5. 8  engine_starter_fail 

This  routine  causes  the  engine  starter  to  fail. 

2. 3. 6. 2. 5. 9  engine_starter_fix 

This  routine  repairs  the  engine  starter. 

2.3.6.2.5.10  engine_running 

This  routine  returns  engine  state:  either  ON  or  OFF. 


1  Return  Values  1 

Return  Value 

Type 

Meanlno 

ON 

int 

Engine  is  oinning. 

OFF 

int 

Engine  is  not  running. 

Table  2.3-345:  engine_running  Information. 
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2.3.6.2.5.11  engine_speed 
This  routine  returns  the  engine  speed. 


1  Return  Values  1 

Return  Value 

Meaning 

enaine.speed 

REAL 

Engine  speed. 

Table  2.3-346:  engine_speed  Information. 


2.3.6.2.5.12  engine_get_speed 
This  routine  returns  the  engine  speed  in  rpm. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

RADSEC_TO_RPM  * 
engine. speed 

REAL 

Engine  speed  in  rpm. 

Table  2.3-347:  engine_get_speed  Information. 


2.3.6.2.5.13  engine^rpm 


This  routine  returns  the  engine  speed  in  rpm. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

RADSEC_TO_RPM  * 
engine. speed 

REAL 

Engine  speed  in  rpm. 

Table  2.3-348:  engine_rpm  Information. 


2.3.6.2.5.14  engine_get_max_power 


This  routine  returns  the  engine's  maximum  power. 


1  Return  Values  1 

Return  Value 

1  Meaning  I 

engine.power  percent 

REAL 

Table  2.3-349:  engine_get_max_power  Information. 
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2.3.6.2.5.15  engine_set_throttle 

This  routine  sets  the  engine's  throttle  equal  to  the  input  val. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

val 

REAL 

Sim  types. h 

Table  2.3-350:  engine_set_throttIe  Information. 


2.3.6.2.5.16  engine_run 

This  routine  sets  the  engine's  torque,  load,  acceleration,  and  speed.  The  routine  calls  for 
sound  generation  of  for  the  particular  speed. 


1  Internal  Variables  I 

1  Internal  Variable 

Where  Typedef  Declared 

1  throttle 

REAL 

Sim  types. h 

1  Calls  1 

Function 

Where  Described 

fit  enaine  toraue 

Section  2.3.6.2.5.19 

transmission  load  torque 

Section  2.3.6.2.2.9 

controller  oear 

Section  2.3.6.2.3.8 

enaine  off 

Section  2.3.6.2.5.18 

sound  of  enqine 

Section  2.1.3.3.16 

fable  2.3-35i:  engine_run  Information. 


2.3.6.2.5.17  engine_crank 

This  routine  is  called  to  start  the  engine.  Routines  are  called  to  generate  cranking  sound 
effects  according  to  the  starting  state  of  the  engine. 


1  Internal  Variables  1 

internal  Variable 

Type 

Where  Typedef  Declared  I 

new  state 

int 

Standard  i 

Calls 

Function 

Where  Described 

electsys_engine_start_reque 

St 

Section  2.2.6.3.1.8 

sound_of_engine_cranking_ 

Start 

Section  2.1.3.3.10 

sound_of_engine_cranking_ 

stop 

Section  2.1.3.3.11 

sound  of  enqine  start 

Section  2.1.3.3.14 

Table  2.3-352:  engine_crank  Information. 


2.3.6.2.5.18  engine_off 
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This  routine  sets  the  engine  speed  to  zero,  sets  the  engine  state  to  off,  calls  a  routine  to 
generate  the  engine  stop  sound. 


1  Calls  1 

Function 

Where  Described 

sound  of  enaine  stop 

Section  2.1.3.3.15 

Table  2.3-353:  engine_off  Information. 


2.3.6.2.5.19  fit_engine_torque 

This  routine  calculates  and  returns  torque  using  the  values  of  throttle  and  speed  passed  as 
the  arguments. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

throttle 

REAL 

Sim  types. h 

speed 

REAL 

Sim  types. h 

1  Internal  Variables  1 

Internal  Variable 

Where  Tvpedef  Declared 

X 

REAL 

Sim  types. h 

a 

array  of  4  REAL 

sim  types. h 

torque 

REAL 

Sim  types. h 

torque  qov 

REAL 

sim  types.h 

1  Return  Values  1 

Return  Value 

Meaninq 

M2  ENG  NO  FUEL  TORO 

REAL 

Enqine  fuel  supply  is  off. 

torque 

REAL 

The  engine  torque 

1  Calls  1 

Function 

Where  Described 

max 

Sim  macros.h 

min 

Sim  macros.h 

enqine  power  loss 

Section  2.3.6.2.6.13 

Table  2.3-354:  fit_engine_torque  Information. 


2.3.6.2.5.20  engine_dump 

This  routine  prints  engine  speed,  acceleration,  torque,  power,  and  load. 


1  Calls  1 

Function 

1  Where 

Described 

transmission  load  torque 

1  Section 

Table 

2.3-355: 

enginc  dump  Information. 
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2.3.6.2.5.21  engine_banner 

This  routine  prints  column  headings  for  engine  speed,  acceleration,  torque,  power,  and 
load. 

2.3.6.2.5.22  engine_data_title 
This  routine  prints  the  title,  Engine. 

2.3.6.2.5.23  engine_banner 

This  routine  prints  column  headings  for  speed  and  fuel. 

2.3.6.2.5.24  engine_data_dump 

This  routine  prints  engine  speed  and  fuel  flow. 

2.3.6.2.5.25  engine_init 

This  routine  initializes  the  engine  structure  variables. 


1  Calls  1 

Function 

Where  Described 

fail  init  failure 

Section  2.5.4.11.2 

Table  2.3-356:  enginejnit  Information. 
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2. 3. 6. 2. 6  m2_engfail.c 

(./simneiAelease/src/vehicle/in2/src/m2_engfail.c  [in2_engfail.c) 

Failures  are  simulated  in  m2_engfail.c,  and  consist  of:  air  filter,  oil,  coolant,  fuel  filter,  and 
starter.  The  simulation  routines  are  called  from  m2_ptrain.c. 

Includes: 

"stdio.h" 

"sim_types.h" 

"sim_(tfns.h" 

"sim_macros.h" 

"m2_cons.h" 

"m2_engine.h" 

Defines: 

Failure  areas 
AIR.FILTER 
FUEL_FILTER 
COOLANT 
OIL 

CXAPTTJR 

NUM_ENG_FA1LURES 
FAIL_STAT 

In  the  following  header  structure,  tagged  fail_stat,  "status"  is  NORMAL  or  ISF AILED,  and 
"timer"  is  the  number  of  ticks  since  the  failure  occurred. 


Value 
(int)  0 
(int)  1 
(int)  2 
(int)  3 
(int)  4 
(int)  5 

stmct  fail_stat 


Item 

Where  Type  Defined 

status 

int 

Standard 

timer 

int 

Standard 

Table  2.3-357:  failures[NUM_ENG_FAILURES]  Structure  Definition 

Procedure  declarations: 

check_starter_failure() 

check~engine~failure() 

REAL  declarations: 

initial_power_percent 
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2. 3. 6. 2. 6.1 


engine_coolant_leak 


This  routine  sets  control  indicators  and  status  to  low  level  of  coolant  The  engine  starter 
and  engine  are  failed. 


1  Calls  1 

Function 

Where  Described 

controls  coolant  level  low 

Section  2.3.2 

enaine  starter  fail 

Section  2.3.6.2.5.8 

engine  fail 

Section  2.3.6.2.5.6 

Table  2.3-358:  engine_coolant_leak  Information. 


2. 3. 6. 2. 6. 2  engine_coolant_normal 

This  routine  returns  the  control  indicators  of  coolant  engine  status  to  the  normal  level.  The 
engine  starter  and  engine  are  repaired. 


1  Calls  1 

Function 

Where  Described 

controls  coolant  level  norma 

1 

Section  2.3.2 

engine  starter  fix 

Section  2.3.6.2.5.9 

engine  fix 

Section  2.3.6.2.5.7 

Table  2.3-359:  engine_coolant_normaI  Information. 


2. 3. 6. 2. 6. 3  englne_clog_fuel_filter 

This  routine  sets  control  indicators  and  status  to  fuel  filter  clogged.  The  engine  staner  and 
engine  are  failed. 


1  Calls  1 

Function 

Where  Described 

controls  fuel  filter  clogged 

Section  2.3.2 

engine  starter  fail 

Section  2.3.6.2.5.8 

engine  fail 

Section  2.3.6.2.5.6 

Table  2.3-360:  engine_clog_fueI_filter  Information. 
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2. 3. 6. 2. 6. 4  engine_fix_fuel_filter 


This  rouitne  unsets  the  status  and  control  indicators  from  fuel  filter  clogged.  The  engine 
starter  and  engine  are  repaired. 


1  Calls  1 

Function 

Where  Described 

controls  fuel  filter  normal 

Section  2.3.2 

enaine  starter  fix 

Section  2.3.6.2.5.9 

engine  fix 

Section  2.3.6.2.5.7 

Table  2.3*361:  engine_fix_fuel_filter  Information. 


2. 3. 6. 2. 6. 5  engine_clog_air_fi!ter 

This  routine  sets  control  indicators  and  status  to  air  filter  clogged.  The  engine  starter  and 
engine  are  failed. 


1  Calls  1 

Function 

Where  Described 

controls  air  cleaner  cloaoed 

Section  2.3.2 

enaine  starter  fail 

Section  2.3.6.2.5.8 

engine  fail 

Section  2.3.6.2.5.6 

Table  2.3-362: 


engine_clog_air_filter  Information. 


2. 3. 6. 2. 6. 6  engine_fix_air_filter 

This  rouitne  unsets  the  status  and  control  indicators  from  air  filter  clogged.  The  engine 
starter  and  engine  are  repaired. 


1  Calls  1 

Function 

Where  Described 

controls  air  cleaner  normal 

Section  2.3.2 

engine  starter  fix 

Section  2.3.6  2.5.9 

engine  fix 

Section  2.3.6. 2.5.7 

Table  2.3-363:  engine_fix_air_filter  Information. 


2. 3. 6. 2. 6. 7  engine_oil_leak 

This  routine  simulates  an  oil  leak.  The  engine  starter  and  engine  are  failed. 


1  Calls  1 

Function 

Where  Described 

engine  starter  fail 

Section  2. 3. 6. 2.5.8 

engine  fail 

Section  2.3.6.2.5.6 

Table  2.3-364:  engine_uil_leak  Information. 
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2. 3. 6. 2. 6. 8 


engine_oil_normal 


This  routine  repairs  an  oil  leak.  The  engine  starter  and  engine  are  repaired. 


1  Calls  I 

Function 

Where  Described 

enaine  starter  fix 

Section  2.3.6.2.5.9 

enaine  fix 

Section  2.3.6.2.5.7 

Table  2.3>365:  engine_oil_normaI  Information. 


2. 3. 6. 2. 6. 9  engine_fail_starter 

This  routine  sets  the  engine  starter  status  to  fail.  The  engine  starter  is  failed. 


1  Calls  1 

Function 

Where  Described 

enqine.  starter  fail 

Section  2.3.6.2.5  8 

Table  2.3-366:  engine_fail_starter  Information. 


2.3.6.2.6.10  engine_fix_starter 


This  routine  repairs  the  engine  starter,  resetting  its  status  to  normal. 


1  Calls  1 

Function 

Where  Described 

engine  starter  fix 

Section  2.3.6. 2.5.9 

Table  2.3-367:  engine_fix_starter  Information. 


2.3.6.2.6.11  engine_failure_update 

This  routine  increments  the  appropriate  failure  timer  if  the  status  of  an  engine  subsystem  is 
fail. 


1  Internal  Variables  1 

Internal  Variable 

Type 

Where  Typedef  Declared 

fP 

pointer  to  FAIL  ST AT 

Section  2. 3. 6. 2. 6 

Table  2.3-368:  engine_failure_update  Information. 
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2.3.6.2.6.12  engine_init_power 

This  routine  sets  the  initial  power  level  of  the  engine  to  val,  which  is  passed  as  an 
argument. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

val 

REAL 

Sim  tvoes.h 

Table  2.3-369:  engine_init_power  Information. 


2.3.6.2.6.13  engine_power_loss 

This  routine  calculates  the  reduction  in  the  power  level  due  to  a  clogged  oil  filter,  clogged 
air  filter,  leaking  fuel,  Md  leaking  coolant.  The  reduced  power  level  value  is  returned. 


1  Internal  Variables  I 

Internal  Variable 

Where  Typedef  Declared 

power  percent 

REAL 

sim  tvoes.h 

1  Return  Values  I 

Return  Value 

Meanina 

initial_power_percent  * 
power  percent 

REAL 

The  reduced  power  level. 

1  Calls  1 

Function 

Where  Described 

min 

Sim  macros.h 

max 

Sim  macros.h 

engine  off 

Section  2.3.6.2.5.18 

Table  2.3-370:  engine_power_loss  Information. 


2.3.6.2.6.14  check_starter_failure 

This  routine  checks  whether  there  is  a  failure  of  the  air  filter,  fuel  filter,  coolant,  oil,  or 
starter. 


1  Return  Values  I 

Return  Value 

Meaning 

TRUE 

int 

Air  filter  or  fuel  filter  or  coolant 
or  oil  or  starter  is  failed. 

FALSE 

int 

None  of  the  above  is  failed. 

Table  2.3-371:  check  starter  failure  Information. 
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2.3.6.2.6.15  check_engine_failure 

This  routine  checks  whether  there  is  a  failure  of  the  air  filter,  fuel  filter,  coolant,  or  oil. 


1  Return  Values  1 

Return  Value 

Type 

Meanina 

TRUE 

int 

Air  filter  or  fuel  filter  or  coolant 
or  oil  is  failed. 

FALSE 

int 

None  of  the  above  is  failed. 

Table  2.3-372:  check_eng!ne_failure  Information. 


2. 3. 6. 3  Vehicle  Subsystems 

The  eSU's  required  to  simulate  the  M2's  subsystems  are  as  follows. 

m2_elecsys.c 

ni2_vision.c 

m2_isu.c 


2. 3. 6. 3.1  m2_elecsys.c 

(./simnel/release/src/vehicle/ni2/src/m2_elecsy s.c  [m2_elec  sy s  .c] ) 

The  model  of  the  M2's  electrical  system  is  based  the  assumption  that  charge  and  voltage  are 
linearly  related  and  that  the  battery  charges  linearly  over  time.  While  many  small 
components  (such  as  indicator  lamps)  consume  electrical  charge,  only  the  major  charge 
consumers  are  modeled.  The  major  charge  consumers  consist  of  the  starter,  TOW  missile, 
2.^  mm  gim,  turret  drive  system,  fuel  transfer  pump,  radio,  and  intercom  for  the  M2. 
Routines  to  support  this  model  are  found  in  m2_elecsys.c. 

When  the  engine  is  running,  it  is  assumed  that  all  electrical  components  are  obtaining 
electrical  charge  for  the  altemator/generator,  which  is  modeled  as  an  infinite  amount  of 
charge.  As  long  as  the  engine  is  running  and  the  alternator/  generator  has  not  failed,  all 
requests  for  electrical  charge  are  granted.  The  altemator/generator  will  also  charge  up  a 
battery  which  is  less  than  fully  charged.  However,  if  the  engine  is  off  or  the 
altemator/generator  has  failed,  the  electrical  components  must  obtain  electrical  charge  from 
the  battery. 

Each  of  the  modeled  electrical  components  requires  a  specific  amount  of  electrical  charge  to 
be  present  When  the  component  is  used,  the  electrical  system  is  queried  to  see  if  there  is 
enough  charge  present  to  accommodate  the  request.  If  so,  the  stored  charge  is  depleted  by 
the  amount  requested. 

The  following  assumptions  are  made  in  modeling  the  electrical  system; 

•  Generator  is  220  amps,  regulated  to  24VDC 

•  Hull  Batteries;  4  each,  lOOamp-hr  each,  consisting  of  wet  cells  connected  in  a 

series/parallel  arrangement  for  a  total;  24v,  200amp-hr. 

•  The  hull  is  a  ground. 
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•  The  turret  receives  power  from  the  hull  power  distribution  system. 

•  The  voltage  gage  indicates  the  following  battery  and  generator  conditions: 

left  zone  -  low  battery  charge  with  engine  off.  Battery  may  not  start  the 
engine. 

yellow  zone  -  indicates  normal  battery  voltage  with  engine  off.  Indicates 
generator  not  charging  with  engine  running. 

green  zone  -  indicates  generator  charging  normally  with  engine  running, 
right  red  zone-  indicates  generator  overcharging  with  engine  running. 

•  Turning  the  Master  power  off  before  the  engine  has  stopped  can  damage  the 

electrical  system. 

•  The  turret  electrical  system: 

Opwates  the  25mm  gun,  the  tow  launcher,  and  the  turret. 

The  tow,  12mm  gun,  and  turret  will  no  work  if  the  battery  has  less  than 
18.5v  (LEFT_RED_ZONE_MAX) 

It  takes  approximately  90  minutes  to  recharge  the 
TURRET_EMERGENCY_BATTERIES  from  LEFT_RED_ZONE_MAX 
to  TURRET_MAX_CHARGE; 

•  The  gunner's  handles  control  the  turret  electrically 

•  Drive  system  power  allows  commander  to  override  gunner's  control  of  the  turret: 

Four  12  volt  wet  cell  batteries  located  in  hull 
Two  12  volt  wet  cell  batteries  located  in  turret 
Total:  24v,  lOOamp  -  hr. 

Stabilization  system  is  electric 
25mm  gun  ->  1.5hp  (not  an  assumption) 

•  Due  to  use  of  the  radio: 

Radio  set  operating  power:  22  -  30VDC 
The  radio  can  run  continuously  with  22v  input 
The  radio  can  run  for  1  hour  with  30v  input. 

•  If  the  engine  accessory  switch  is  off,  the  pump  between  the  bottom  and  top  fuel 

tanks  is  off. 

•  With  the  generator  charging  properly,  the  meter  should  remain  fully  within  the 

GREEN  ZONE.  This  is  modeled  linearly  as  in  the  Ml. 

•  The  tow,  12mm  gun,  and  turret  will  not  operate  if  the  battery  has  less  than  18.5v 

(LEFT_RED_ZONE_MAX) .  TOW_DlSCHARGE_RATE  = 
(TURR_MAX_CHARGE  -  LEFT_RED_ZONE_MAX)  * 
TURR_V_TO_(3)/2  due  to  the  fact  that  the  TOW  can  be  fired  twice  with  the 
engine  off. 
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•  The  hull  battery  is  discharged  to  STARTER_MIN_VOLTAGE  (17.5V)  after  four 

30  second  starts.  Therefore,  the  discharge  rate  per  tick  is: 
STARTER_DISCHARGE_RATE  =  (HULL_MAX_VOLTAGE - 
STARTER_MIN_VOLTAGE*  HULL_V_TO_Q  /  (4  *  30sec  *  15  ticks/sec) 
=  (24v  -  17.5v)  ♦  200anip-hr/24v  / 1800  ticks 
=  0.03009259259  amp-hr/tick 

•  The  turret  elevation  drive  has  an  alloted  power  of  32  hp  (an  assumption). 

1  hp  =  746  watts,  therefore  32hp  =  23872  watts, 
power  =  vi,  therefore  current  =  23872  watts/24  volts, 
i  =  dq/dt 

dt  =  1/15  sec/frame  *  1/60  min/sec  *  1/60  hr/min  =  1/54000  hr/tick 
dq  =  23872/24  *  1/54000  =  23872/1296000  amp-hr/tick  for  linear 
discharge. 

=  0.0008634259  amp-hr/tick 
=  TURRET_ELEV_DISCHARGE_RATE 
The  same  value  is  currently  used  for  the 
TURRET_TRAVERSE_DISCHARGE_RATE. 

•  The  25mm  gun  has  an  alloted  power  of  1.5hp  (not  an  assumption). 

1  hp  =  746  watts  ->  1.5hp  =  1119  watts 
power  =  vi  ->  current  =1119  watts/24  volts 
i  =  dq/dt 

dt  =  1/15  sec/frame  *  1/60  min/sec  *  1/60  hr/min  =  1/54000  hr/tick 
dq=  1119/24  *  1/54000=  11 19/1296000  amp-hr/tick  for  Unear 
discharge 

=  0.01841975  amp-hr/tick  =  GUN_25MM_DISCHARGE_RATE 

•  It  takes  approximately  90  minutes  to  recharge  the 

TURRET_BACKUP_BATTERIES  from  LEFT_RED_ZONE_MAX  to 
TURRET_MAX_CHARGE.  The  recharge  rate  is: 
(TURRET_MAX_CHARGE  -  LEFT_RED_ZONE_MAX)/  (90  min  * 
60se<^min  *  15ticks/sec) 

•  The  BATTERY_RECHARGE_RATE  =  0.0002829218  amp-hr/tick. 

•  If  the  generator  fails  while  the  engine  is  running,  the  engine  will  run  for 

approximately  45  minutes.  The  hull  battery  charge  goes  from 
HULL_MAX_VOLTAGE  to  LEFT_RED_ZONE_MIN  in  45  minutes 
(40500  ticks)  due  to  the  running  engine. 

ENGINE_D1SCHARGE_RATE  =  (HULL_MAX_VOLTAGE  - 
LEFT_RED_ZONE_MIN)  /  40500 


Includes: 

"stdio.h" 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h 

"Ubfailh" 

"failure.h" 

"m2_meter.h" 

"m2_engine.h" 


II 
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"m2_cntrl.h" 

"m2_elecsys.h" 

"in2_main.h" 


The  following  conversion  factors  are  defined: 

HULL_MAX_CHARGE 

HULL_MAX_VOLTAGE  24.0 

HULL_V_TO_Q 

HULL_Q_TO_V 

TURR_MAX_CHARGE 

TURR_MAX_VOLTAGE 

TURR_V_T0_Q 

TURR_Q_TO_V 

The  following  zones  on  the  meter  are  defined: 

LEFT_RED_ZONE_MIN 

LEFT_RED_ZDNE_MAX 

YELLOW_ZONE_MAX 

GREEN_ZONE_MAX 

RIGHT_RED_ZONE_MAX 

STARTER_MIN_VOLTAGE  -  approximately  1/4  into  left  red  zone 

STARTER_MIN_CHARGE 

TURR_BATTERY_MIN 

The  following  engine  parameters  are  defined: 

IDLE 

MAX.RADS 

SLOPE 

MIN_RADS  -  if  less  than  this  value,  the  engine  is  off 

The  following  Boolean  values  for  battery  states  are  defined: 

NEW 

DEAD  -  the  battery  holds  no  charge 


Additional  Defines: 

TOW_DISCHARGE_RATE 

STARTER_DISCHARGE_RATE 

TURRET_ELEV_DISCHARGE_RATE 

TURRET_TRAVERSE_DISCHARGE_RATE 

GUN_25MM_DISCHARGE_RATE 

BATTERY_RECHARGE_RATE 

ENGINE_DISCHARGE_RATE 

RADIO_DISCHARGE_RATE 

1NTERC0M_DISCHARGE_RATE 

FUEL_XFER_PUMP_D1SCHARGE_RATE 


iTie  following  are  declared: 

hull_power_status  -  ON  or  OFF 
turret_power_status  -  ON  or  OFF 
turreLbackup_power_status  -  ON  or  OFF 
hull_battery_charge 
turret_battcry_charge 
turret_backup  battery-  ^charge 
hull,_batteiy_itatus  -  NEW  or  DEAD 
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turret_backup3attery_status  -  NEW  or  DEAD 
generator_status  -  WORKING  or  BROKEN 
drive_malfunction_status  -  TRUE  or  FALSE 
gun_25mm_malfunction_status  -  TRUE  or  FALSE 
tow_circuit_open_status  -  TRUE  or  FALSE 
tuTret_electsys_dead 
hull_electsys_dead 

voltmeter_enabled  -TRUE  or  FALSE 
2 . 3 . 6 .3 . 1 . 1  electsys_charge_battery 
This  routine  recharges  the  hull  and  turret  batteries. 


1  Calls  1 

Function 

Where  Described 

min 

Sim  macros.h 

controls_hulLelectsys_rebor 

n 

Section  2.3.2 

controls_turret_backup_elect 
SYS  reborn 

Section  2.3.2 

Table  2.3-373:  electsys_charge_battery  Information. 


2. 3. 6. 3. 1.2  electsys_discharge_hull_battery 
This  routine  discharges  the  battery  by  delta  if  the  engine  is  off. 

I  _ _ 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

delta 

REAL 

sim  types. h 

1  Calls  1 

Function 

Where  Described 

max  (macro  definition) 

Sim  macros.h 

fail  break  system 

Section  2.5.4.8.1 

Table  2.3-374:  electsys_discharge_hull_battery  Information. 
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2 . 3 . 6 . 3 . 1 . 3  electsys_discharge_turret_back  up_battery 
This  routine  discharges  the  turret  backup  battery  by  delta  if  the  engine  is  off. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

delta 

REAL 

Sim  types. h 

1  Calls  1 

Function 

Where  Described 

max  (macro  definition) 

Sim  macros.h 

fail  break  system 

Section  2.5.4.8.1 

Table  2.3-375;  electsys_discharge_turret_backup_battery  Information. 


2 . 3 . 6 . 3 . 1 . 4  electsys_rads_to_voI  ts 

This  routine  allows  the  electrical  system  meter  to  reflect  the  change  in  rpms  of  the  engine. 
It  is  only  used  with  the  engine  on.  This  is  accomplished  by  the  y  =  mx  +  b  formula  where 
y  is  volts  and  x  is  rads  per  sec.  The  y  values  are  the  entire  GREEN  ZONE  of  the  meter. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

rads 

REAL 

Sim  types. h 

I  Return  Values  1 

Return  Value 

Meaning 

YELLOW_ZONE_MAX 

static  REAL 

voltmeter  value 

GREEN_ZONE_MAX 

static  REAL 

voltmeter  value 

SLOPE*(rads-IDLE)  + 

HULL  MAX  VOLTAGE 

Static  REAL 

voltmeter  value 

Table  2.3-376;  electsys_rads_to_volts  Information. 
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2 . 3 . 6 . 3 . 1 . 5  electsys_handle  Jeaky_hull_ba  ttery 

This  routine  handles  the  case  of  a  leaky  battery.  The  batteiy  charges  up,  but  when  the  load 
is  applied,  die  voltage  immediately  drops  to  \V^AKLY_CHARGED.  The  battery  charge 
drops  to  limit  after  die  load  has  been  applied.  It  corresponds  to  the  value  of  the  Left 
Zone  converted  to  charge. 


1  Internal  Variables  I 

Internal  Variable 

Where  Typedef  Declared 

Limit 

REAL  1 

Sim  types. h 

1  Calls  1 

Function 

Where  Described 

electsys_turret_backup _pow 
er  request 

Section  2.3.6.3.1.7 

controls  hull  electsvs  dead 

Section  2.3.2 

Table  2.3-377:  electsys_handle_leaky_hull_battery  Information. 


2 . 3 . 6 . 3 . 1 . 6  electsys_handle_leaky_turret_backu  p_battery 

This  routine  handles  the  case  of  a  leaky  turret  backup  battery.  The  battery  charge  drops  to 
limit  after  the  load  has  been  applied.  It  corresponds  to  the  value  of  the  Left  Red  Zone 
converted  to  charge. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

Limit 

REAL 

Sim  types. h 

Calls 

Function 

Where  Described 

controls_turret_hackup_elect 
SYS  dead 

Section  2.3.2 

Table  2.1-378:  electsys_handle_leaky_turret_backup_battery  Information. 
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2 . 3 . 6 . 3 . 1 . 7  eIectsys_turret_backup_power_request 

This  routine  is  called  to  make  sure  the  turret  backup  power  can  be  turned  on  if  the  hull 
power  is  not  on. 


Return  Values 


Return  Value 


turret_backup_power_status  static  BOOLEAN 


Meaning 


status  of  the  turret  backup 
power,  either  ON  or  OFF 


Calls 

Function 

Where  Described 

controls_commander_backup 
power  on 

Section  2.3.2 

controls_commander_backup 
power  off 

Section  2.3.2 

Table  2.3-379:  eIectsys_turret_backup_power_request  Information. 

2. 3. 6. 3. 1.8  electsys_simul 

If  the  engine  is  running  and  generator_status  is  true,  then  the  engine  is  running  off  the 
generator  rather  than  the  battery.  When  the  engine  is  running  with  the  generator,  the 
battery  is  recharged.  The  banery  discharges  when  the  engine  is  running  off  the  battery  and 
when  the  engine  is  off. 


Internal  Variable 


enoine  rads 


e 


REAL 


Internal  Variables 


Where  Tvpedef  Declared 


Sim  types. h 


Calls 


Where  Described 


Section  2.3.6.2.5.11 


Section  2.3.2.3.3 


Section  2.3.6.2.5.10 


electsvs  charoe  battery  I  Section  2.3.6.3.1 .1 


electsys_discharge_hull_batt  Section  2.3.6.3.1.2 
ery 


Function 


enoine  speed 


meter  volt  set 


Table  2.3-380:  electsys_simul  Information. 
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2.3.6.3.1.9 


electsys_hull_dead 


This  routine  sets  the  hull  electrical  system  to  the  dead  state,  hull  electsys  dead  is  set  to 
TRUE,  and  hull  j)ower  status  is  set  to  OFF. 


1  Calls  1 

Function 

Where  Described 

controls  hull  electsys  dead 

Section  2.3.2 

Table  2.3-381:  electsys_hull_dead  Information. 


2.3.6.3.1.10  electsys_turret_dead 


This  routine  sets  the  tuiret  electrical  system  to  the  dead  state,  turret  electsys  dead  is  set  to 
TRUE,  and  turret  backup _power  status  is  set  to  OFF. 


1  Calls  1 

Function 

Where  Described 

controls_turret_backup_elect 

svs.dead 

Section  2.3.2 

Table  2.3-382:  electsys_turret_dead  Information. 


2.3.6.3.1.11  electsys_dead 

This  routine  calls  routines  which  set  the  hull  and  tunet  electrical  systems  to  the  dead  state. 


1  Calls  1 

Function 

Where  Described 

electsys  hull  dead 

Section  2.3.6  3.1. 9 

electsys  turret  dead 

Section  2.3.6.3.1.10 

Table  2.3-383:  electsys_dead  Information. 


2.3.6.3.1.12  electsys_drive_malfunction_status 
This  routine  returns  the  drive  malfunction  status. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

drive_matfunction_status 

BOOLEAN 

drive  malfunction  status 

TRUE  -  malfunctioning 

FALSE  -  functioning 

Table  2.3-384:  electsys_drive_malfunction_status  Information. 
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2.3.6.3.1.13  electsys_set_tu rret_dri ve_status 
This  routine  sets  the  turret  drive  status  to  status. 


1  Parameters  I 

Parameter 

Where  Tvoedef  Declared 

status 

BOOLEAN 

Sim  types. h 

Table  2.3*385:  electsys_set_turret_drive_status  Information. 


2.3.6.3.1.14  electsys_25mm_gun_malfunction_stat us 
This  routine  returns  the  2Sinm  gun  malfunction  status. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

gun_25mm_malfunction_stat 

us 

BOOLEAN 

25mm  gun  malfunction  status 
TRUE  -  malfunctioning 

FALSE  -  functionina 

Table  2.3-386:  electsys_25mm_gun_malfunction_status  Information. 


2.3.6.3.1.15  electsys_set_25mm_gun_maIfunction_status 
This  routine  sets  the  25mm  gun  malfunction  status  to  status. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

status 

BOOLEAN 

Sim  types. h 

Table  2.3-387:  electsys_set_25mm_gun_malfunction_status  Information. 


2.3.6.3.1.16  electsys_tow_ci rcu it_open_sta t us 
This  routine  returns  the  tow  circuit  open  status. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

tow_circuit_open_status 

BOOLEAN 

status  of  tow  circuit 

TRUE  -  open  circuit 

FALSE  -  closed  circuit 

Table  2.3-388:  electsys_tow_circuit_open_status  Information. 
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2.3.6.3.1.17  electsy s_set_tow_circuit_open_status 
This  routine  sets  the  tow  circuit  open  status  to  status. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

status 

BOOLEAN 

the  tow  circuit  open  status 

Table  2.3-389:  electsys_set_tow_circuit_open_status  Information. 


2.3.6.3.1.18  electsys_hull_power_request 


This  routine  is  called  by  the  controls  routines  to  make  sure  the  hull  power  can  be  turned  on. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

hull power status 

BOOLEAN 

the  status  of  hull  power 

1  Calls  1 

■  Function 

Where  Described 

Section  2.3.6.2.5.10 

controls_commander_backup 
power  off 

Section  2.3.2 

Table  2.3-390:  electsys_hull_power_request  Information. 


2.3.6.3.1.19  electsys_turret_power_request 

This  routine  is  called  by  the  controls  routines  to  make  sure  the  turret  power  can  be  turned 
on. 


I  Return  Values  I 

Return  Value 

Type 

Meaning  | 

turret_power_status  =  ON 

BOOLEAN 

electsy  s_tu  rret_backup_pow 
er  requestO 

BOOLEAN 

is  backup  power  available? 

I  Calls  I 

Function 

Where  Described 

electsys_turret_backup_pow 
er  request 

Section  2.3. 6.3.1 .7 

Table  2.3-391:  electsys_turret_power_request  Information. 
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2.3.6.3.1.20  electsy  s_engin  e_sta  rt_request 

This  routine  detennines  if  the  battery  is  sufficiently  charged  for  the  engine  to  be  started  and 
determines  the  charge  by  the  STARTER_DISCHARGE_RATE. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

TRUE 

BOOLEAN 

engine  can  be  started 

FALSE 

BOOLEAN 

engine  cannot  be  started 

Calls 

Function 

Where  Described 

electsys_discharge_hull_batt 

erv 

Section  2.3.6.3.1.2 

Table  2.3-392:  electsys_engine_start_request  Information. 


2.3.6.3.1.21  electsys_tow_request 

This  routine  determines  if  the  Tow  launcher  can  be  operated.  If  it  can,  the  routine  returns 
TRUE.  If  the  TOW  launcher  is  not  working  or  if  there  is  insufficient  power  for  TOW 
operation,  the  routine  returns  FALSE. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

TRUE 

BOOLEAN 

engine  is  running  or  sufficient 
battery  power  for  operation  is 
available 

FALSE 

BOOLEAN 

Tow  circuit  open,  TOW  not 
working,  or  insufficient  power 
available 

1  Calls 

Function 

Where  Described 

electsys_discharge_hull_batt 

erv 

Section  2.3. 6.3. 1.2 

electsys_discharge_turret_ba 
ckuD  battery 

Section  2.3.6.31. 3 

Table  2.3-393: 


electsys_tow_request  Information. 
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2.3.6.3.1.22  eIectsys_turret_elevation_request 


This  routine  determines  u  i  turret  elevation  can  be  adjusted  If  the  drive  is  broken  or  if 
there  is  insufficient  power  av.^able,  the  elevation  cannot  be  adjusted  and  the  routine  returns 
FALSE.  Otherwise,  the  elevation  can  be  adjusted  and  the  routine  returns  TRUE,  percent 
is  the  percent  of  maximum  slew  rate  (handle+stab  displacement). 


1  Parameters  | 

Parameter 

Tvpe 

Where  Typedef  Declared 

percent 

REAL 

Sim  types. h 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

TRUE 

BOOLEAN 

elevation  can  be  adjusted 

FALSE 

BOOLEAN 

elevation  cannot  be  adjusted 

-  drive  is  broken 

-  power  insufticient  or 
unavailable 

1  Calls  1 

■  Function 

Where  Described 

r  ■  1  i  r.  1 1  ■  LH  J 1 1  f  1 1 

Section  2.3.6.2.5.10 

electsys_discharge_hull_batt 

erv 

Section  2.3.6.3.1.2 

electsys- 

discharge_turret_backup_batt 

erv 

Section  2.3.6.3.1.3 

Table  2.3-394:  electsys_turret_elevation_request  Information. 
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2.3.6.3.1.23  electsy s_tu rret_t ra verse_request 

This  routine  determines  if  the  turret  traverse  position  can  be  adjusted.  If  the  drive  is  broken 
or  if  there  is  insufficient  power  available,  the  traverse  position  cannot  be  adjusted  and  the 
routine  returns  FALSE.  Otherwise,  the  traverse  position  can  be  adjusted  and  the  routine 
returns  TRUE,  percent  is  the  percent  of  maximum  slew  rate  (handle+stab  displacement). 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

oercent 

REAL 

Sim  types. h 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

TRUE 

BOOLEAN 

traverse  position  can  be 
adjusted 

FALSE 

BOOLEAN 

traverse  position  cannot  be 
adjusted 

-  drive  is  broken 

-  power  insufficient  or 
unavailable 

i  Calls  1 

Function 

Where  Described 

enaine  runninq 

Section  2.3.6.2.5.10 

electsy  s_discharge_hull_batt 
en^ 

Section  2.3.6.3.1.2 

electsys_dischargejurret_ba 
ckuD  battery 

Section  2.3.6.3.1.3 

Table  2.3-395:  electsys_turret_transverse_request  Information. 


2.3.6.3.1.24  electsys_25mm_gun_request 


This  routine  determines  if  the  25mm  gun  can  be  operated.  It  returns  TRUE  if  the  gun  can 
be  operated  and  retuns  FALSE  otherwise. 


Return  Values  1 

Return  Value 

Type 

Meaning 

TRUE 

BOOLEAN 

can  be  operated 

FALSE 

BOOLEAN 

cannot  be  operated 

Calls 

Function 

Where  Described 

enqine  runninq 

Section  2.3.6.2.5.10 

clectsys  discharge  hiii|_batt 
ery 

Section  2.3  6.3. 1.2 

electsys- 

discharge  luriet.  'jacKi.p_batt 
ery 

Section  2. 3. 6. 3.1  3 

Tabit  2.  ^-396:  elect.sys_25mm_gun_reque‘t  Information. 
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2.3.6.3.1.25  electsys_fuel_xfer_pump_request 


This  routine  determines  if  the  fuel  transfer  pump  can  be  operated.  If  the  engine  is  running 
or  if  there  is  sufficient  battery  power  available,  the  pump  will  operate,  and  Ae  routine  will 
return  TRUE.  If  there  is  not  sufficient  power  available,  the  pump  will  not  run  and  the 
routine  returns  FALSE. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

TRUE 

BOOLEAN 

pump  will  operate 

FALSE 

BOOLEAN 

pump  will  not  operate 

1  Calls  1 

■  Function  1 

Where  Described 

Section  2.3.6.2.5.10 

electsys_discharge_hull_batt 

ery 

Section  2.3.6.3.1.2 

Table  2.3-397;  electsys_fuel_xfer_pump_request  Information. 


2.3.6.3.1.26  electsys_get_huII_battery_voItage 


This  routine  returns  the  current  hull  battery  voltage. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

hull  battery  charge*HULL  Q 
TO  V 

REAL 

the  current  hull  battery  voltage 

Table  2.3-398:  eIectsys_get_hull_battery_voUage  Information. 


2.3.6.3.1.27  electsys_get_turret_backup_battery_voI tage 
This  routine  returns  the  current  turret  backup  battery  voltage. 


I  Return  Values  1 

Return  Value 

Type 

Meaning 

turret  backup  battery  charg 
e*TURR  Q  TO  V 

REAL 

the  current  turret  backup 
battery  voltaqe 

Table  2.3-399;  electsys_get_turret_backup_battery_voItage  Information. 


2.3.6.3.1.28  electsys_replace_generator 
This  routine  sets  the  generator  status  to  WORKING. 

2.3.6.3.1.29  electsys_generator_failure 
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This  routine  sets  generator  status  to  BROKEN.  When  the  generator  fails,  the  engine  runs 
off  the  battery,  which  lasts  approximately  45  minutes. 


2.3.6.3.1.30  electsys_replace_huli_battery 
This  routine  replaces  a  dead  hull  battery. 


1  calls  1 

Function 

Where  Described 

controls_hulLelectsys_rebor 

n 

Section  2.3.2 

Table  2.3-400:  electsys_replace_hull_battery  Information. 


2.3.6.3.1.31  electsys_replace_tu  rret_backu  p_bat  te  ry 
This  routine  replaces  a  dead  turret  backup  battery. 


1  Calls  1 

Function 

Where  Described 

controls_turret_backup_elect 
svs  reborn 

Section  2.3.2 

Table  2.3-401:  electsys_replace_turret_backup_battery  Information. 

2.3.6.3.1.32  electsys_tu rret_power_off 

This  routine  turns  the  turret  power  off  by  setting  turret _power_status  to  OFF  and  setting 
turret  backup  jjower  status  to  OFF. 

2.3.6.3.1.33  electsys_hull_power_off 

This  routine  turns  the  hull  power  off  by  setting  fuill _power  status  to  OFF.  Turret  backup 
power  is  requested. 


Calls 


Function 


electsys_turret_backup_pow 
er  request _ 


Where  Described 


Section  2.3.6  3.1. 7 


Table  2.3-402:  electsys_hull_power_off  Information. 
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2.3.6.3.1.34  print_electsys_variables 

The  following  data  is  printed: 
hull_battery_charge 
turretbackupbatterycharge 
hull jpower  status 
turret _power  status 
turret  backup _power  status 
hull_electsys_dead 
turretelectsysdead 


2.3.6.3.1.35  eIectsys_reborn 

This  routine  reactivates  the  M2's  electrical  system. 


1  Calls  1 

Function 

Where  Described 

electsvs  hull  reborn 

Section  2.3.6.3.1.37 

electsys  turret  reborn 

Section  2.3.6.3.1.36 

Table  2.3-403:  electsys_reborn  Information. 


2.3.6.3.1.36  electsys_tu rret_reborn 

This  routine  reactivates  the  turret's  electrical  system. 


1  Caiis  1 

Function 

Where  Described 

controls_turret_backup_elect 
SYS  reborn 

Section  2.3.2 

Table  2.3-404:  electsys_turret_reborn  Information. 


2.3.6.3.1.37  electsys_hull_reborn 


This  routine  reactivates  the  hull's  electrical  system. 


1  Caiis  1 

Function 

Where  Described 

controls_hull_electsys_rebor 

n 

Section  2.3.2 

Table  2.3-405:  electsys_hull_reborn  Information. 
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2.3.6.3.1.38  electsys_init_batteries 

This  routine  initializes  the  hull  and  turret  backup  batteries. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

hull 

REAL 

sim_types.h 

turret 

REAL 

Sim  types.h 

Table  2.3-406:  electsys_init_batteries  Information. 


2.3.6.3.1.39  electsys_voltmeter_disabled 

This  routine  disables  a  voltmeter  by  setting  voltmeter  enabled  to  FALSE. 


2.3.6.3.1.40  electsys_init 

This  routine  initializes  the  M2's  electrical  system. 


1  Calls  1 

Function 

Where  Described 

meter  volt  set 

Section  2.3.2.3.3 

fail  init  failure 

Section  2.5.4.11.3 

Table  2.3-407:  electsys_init  Information. 
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2. 3. 6. 3. 2  m2_vision.c 

(./simnetAelease/src/vehicle/ni2/src/m2_vision.c  [m2_vision.c]) 

The  routines  which  control  the  state  of  the  individual  viewports  are  found  in  m2_vision.c. 
These  routines  break  the  viewports  (turn  them  off)  and  fix  them  by  toggling  bits  in 
libvflags.  The  ability  of  the  cupolas  to  pitch  up  and  down  is  also  controlled  in  the  vision 
files.  Furthermore,  on  the  M2,  the  gunner's  unity  vision  block  and  the  commander's  right 
vision  block  both  change  resolution  and  shape  to  become  the  gunner's  isu  and  gunner’s  isu 
extension  respectively. 

You  must  send  a  view  mode  message  any  time  you  want  to  change  the  screen  resolution 
(cmdr_rt/gnr_isu_ext) . 

Branch  indices  and  branch  masks  have  the  following  meaning: 


branch  index 

0 

branch  mask 

4 

purpose 

cmdr  rt  ISU/standard 

T=ISU 

2 

1 

cmdr  rt  ISU/standard 

T=ISU 

1 

1 

cmdr  It  ISU  4x/12x 

T=4x 

0 

1 

cmdr  pitch  up/oth? 

T=up 

0 

2 

cmdr  pitch  dn/none? 

T=down 

1 

2 

gnr  ISU/standard 

T=ISU 

3 

1 

gnr  ISU/standard 

T=ISU 

1 

1 

gnr  4x/12x 

T=4x 

Includes: 

"stdio.h" 

"math.h" 

"sim_types.h" 

"sim_dfns.h" 

"sim_macros.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"failure.h" 

"libvflags.h" 

"libfailh" 

"m2_vision.h" 


Defines: 

Symbol  Value 

GNR_MAG  0x0001 

CMDR_BR_VAL  0 

CMDRJSU.VAL  2 

GNR_ISU_VAL  3 

ISU_MAG_VAL  1 

ISU.BIT  0x0001 

TC.DEFAULT  0x34ff 

TC_GNR_ISU  0x8400 

TC_CMDR_ISU  0x4400 

SKY_ZERO  0 

SKY.ONE  1 

SKY_TWO  2 

SKY.THREE  3 
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DVRS_FAR_LT 

DVRS_LT 

DVRS_CTR 

DVRS_RT 

CMDR.LT 

CMDR_CTR 

CMDR.RT 

GNR.VIEWP 

DVRS_VIEWP 

CMDRS_VffiWP 

GNR_ISU_WORKING 

GNR_WORKING 

CMDR_ISU_WORKING 

CMDR_WORKING 

GNR_ISU_BROKEN 

GNE_BROKEN 

CMDR_ISU_BROKEN 

CMDR.BROKEN 

vision_block_self_repair 

ISU_SELECTED 

ISU_DESELECrED 

VM_CMR_RT 

VM_GNR 

VM_CMR_CrR 

VM_CMR_LT 

VM_CVR_RT 

VM_CVR_FLT 

VM_DVR_CrR 

VM  DVR  LT 


VIEWP_5 

VffiWP_7 

VffiWP_6 

VffiWP_l 

VIEWP_4 

VffiWP_3 

VffiWP.O  ISU  ext 

VffiWP_2  ISU 

(DVRS_FAR_LT  I  DVRS_LT  I  DVRS.CRT  I 
DVRS_RT) 

(CMDR_LT  I  CMDR_CTR  1  CMDR_RT) 
GNR_VIEWP 
GNR_VIEWP 
CMDR_RT 
CMDR_RT 
0x0 
0x0 
0x0 
0x0 
.TIME 
1 
0 
0 

1 

2 

3 

4 

5 

6 
7 


10 


minutes 


definitions  for  configuration 
viewports  and  view  modes 


int  declarations  and  initialization: 
sky_color 

brow_pad_changed  =  FALSE 
cmdr_isu_status  =  CMDR_ISU_WORKING 
cmdr_status  =  CMDR_WORKING 
gunner_isu_status  =  GNR_ISU_WORKING 
gunner_status  =  GNR_WORKJNG 
gunner_state  =  ISU_DESELECTED 
cmdr_state  =  ISU_DESELECTED 


Procedure  declarations: 

fit_engine_torque() 

engine_run() 

engine_crank() 

engine„offi) 


REAL  declarations: 

engine,  speed_fraction 
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2. 3. 6. 3. 2.1  vision_get_sky_coIor 
This  routine  returns  the  sky  color. 


1  Return  Values  1 

Return  Value 

EinSiiHHHiiH 

Meaning 

sky  color 

int 

The  sky  color 

Table  2.i-468:  vision_get_sky_coIor  information. 


2. 3. 6. 3. 2. 2  vision_toggle_sky_color 
This  routine  toggles  the  sky  color. 


2. 3. 6. 3. 2. 3  cig_gps_mag_12x 


This  routine  switches  the  gunner's  primary  sight  unit  to  the  magnification  of  12X. 


1  Calls  1 

Function 

Where  Described 

cir  br  bit 

Section  2.1.2.2.4.1.1 

clear  view  flags 

Section  2.1.2.2.4.2.1 

set  br  bit 

Section  2.1. 2.2.4. 6.1 

Table  2.3-409:  cig_gps_inag_12x  Information. 


2. 3. 6. 3. 2. 4  cig_gps_mag_4x 


This  routine  switches  the  gunner's  primary  sight  unit  to  the  magnification  of  4X. 


1  Calls  1 

Function 

Where  Described 

set  br  bit 

Section  2.1. 2.2.4. 6.1 

clear  view  flags 

Section  2.1.2.2.4.2.1 

Table  2.3-410:  cig_gps_mag_4x  Information. 


2. 3. 6. 3. 2. 5  vision_cmdrs_pitch_up 


This  routine  pitches  up  the  commander's  vision. 


1  Calls  1 

Function 

Where  Described 

set  br  vals 

Section  2.1.2.2.4.7.1 

clear  view  flags 

Section  2.1.2.2.4.2.1 

set  br  bit 

Section  2.1. 2.2.4  6. 1 

Table  2.3-411:  vision_cmdrs_pitch_up  Information. 
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2 . 3 . 6 . 3 . 2 . 6  vision_cindrs_pitch_ahead 
This  routine  pitches  ahead  the  commander's  vision. 


1  Calls  1 

Function 

Where  Described 

set  br  vals 

Section  2.1.2.2.4.7.1 

clear  view  flaas 

Section  2.1.2.2.4.2.1 

set  br  bit 

Section  2.1.2.2.4.6.1 

Table  2.3>412:  vision_cindrs_pitch_ahead  Information. 


2 . 3 . 6 . 3 . 2 . 7  vision_cmd  rs_pi  tch_down 
This  routine  pitches  down  the  commander's  vision. 


1  Calls  1 

Function 

Where  Described 

set  br  vals 

Section  2.1.2.2.4.7.1 

clear  view  flaas 

Section  2.1.2.2.4.2.1 

set  br  bit 

Section  2.1.2.2.4.6.1 

vlsion_cmdrs_pitch_down  Information. 


Table  2.3-413: 
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2 . 3 . 6 . 3 . 2 . 8  vision_restore_all_blocks 

This  routine  sets  view  flags  and  view  modes  to  restore  vision  on  all  the  screens. 


1  Internal  Variables  1 

Internal  Variable 

Tvoe 

Where  Typedef  Declared 

i 

int 

Standard 

Calls 

Function 

Where  Described 

set  view  fiaas 

Section  2.1.2.2.4.8.1 

set  vmodes 

Section  2.1.2.2.4.9.1 

Table  2.3-414:  vision  restore  all  blocks  Information. 


2 . 3 . 6 . 3 . 2 . 9  vision_break_all_blocks 

This  routine  clears  view  flag  bits  for  all  views,  blackening  all  the  screens  when  catastrophic 
kill  occurs. 


1  Internal  Variables  j 

Internal  Variable 

Where  Tvoedef  Declared 

i 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

clear  view  fiags 

Section  2.1.2.2.4.2.1 

set  vmodes 

Section  2.1.2.2.4.9.1 

Table  2.3-415:  vision  break  all  blocks  Information. 


2.3.6.3.2.10  vision_break_isu 

This  routine  clears  view  flag  bits,  blackening  the  screen  representing  the  integrated  sight 
unit  (isu)  of  the  gunner. 


I  Errors  I 

■  Error  Name 

Reason  for  Error 

I  unknown  gunner  state  ... 

The  variable  gunner  state  has  an  unexpected  value. 

Calls 

Function 

Where  Described 

clear  view  flags 

Section  2.1.2.2.4.2.1 

set  vmodes 

Section  2.1.2.2.4.9.1 

Table  2.3-416:  vision  break  isu  Information. 
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2.3.6.3.2.11  vision_break_isu_ext 

Tbiis  routine  clears  view  flag  bits,  blackening  the  screen  representing  the  integrated  sight 
uniit  extension  of  the  commander. 


f  Errors  I 

lEn^or  Name 

Reason  for  Error 

1  unk:nown  cmdr  state ... 

The  variable  cmdr  state  has  an  unexpected  value. 

Calls 

Fuinctlon 

Where  Described 

clear  view  tlaas 

Section  2.1.2.2.4.2.1 

set  vmodes 

Section  2.1.2.2.4.9.1 

Table  2.3*417:  vision  break  isu  ext  Information. 


2.3.6.3.2.12  vision_break_driver_blocks 

Tims  routine  clears  view  flag  and  view  mode  bits,  blackening  the  screen  used  by  the  driver. 


1  Calls  1 

Fuinctlon 

Where  Described 

clear  view  tlaas 

Section  2.1.2.2.4.2.1 

set  vmodes 

Section  2.1. 2  2.4.9. 1 

Table  2.3*418:  vision  break  driver  blocks  Information. 


2.3.6.3.2.13  vision_break__cmd rs_blocks 

Tbiis  routine  clears  view  flag  and  view  mode  bits,  blackening  the  screen  used  by  the 
cwmmander. 


1  Errors  I 

Error  Name 

Reason  for  Error 

unknown  cmdr  state ... 

The  variable  cmdr  state  has  an  unexpected  value. 

Calls 

Function 

Where  Described 

clear  view  flags 

Section  2.1.2.2.4.2.1 

set  vmodes 

Section  2.1.2.2.4.9.1 

Table  2.3-419:  vision  break  cmdrs  blocks  Information. 
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2.3.6.3.2.14  vision_restore_isu 

This  routine  sets  view  flag  and  view  mode  bits,  restoring  the  view  on  the  screens  used  for 
the  integrated  sight  unit  of  the  gunner. 


1  Errors  1 

1  Error  Name 

Reason  for  Error 

1  unknown  aunner  state  ... 

The  variable  gunner  state  has  an  unexpected  value. 

Calls 

Function 

Where  Described 

set  view  flags 

Section  2.1.2.2.4.8.1 

clear  view  flaas 

Section  2.1.2.2.4.2.1 

set  vmodes 

Section  2.1.2.2.4.9.1 

Table  2.3-420:  vision  restore  isu  Information. 


2.3.6.3.2.15  vision_restore_isu_ext 

This  routine  sets  view  flag  and  view  mode  bits,  restoring  the  view  on  the  screens  used  for 
the  integrated  sight  unit  extension  of  the  commander. 


I  Errors  I 

Error  Name 

Reason  for  Error 

unknown  cmdr  state ... 

The  variable  cmdr  state  has  an  unexpected  value. 

Calls 

Function 

Where  Described 

set  view  flags 

Section  2.1.2.2.4.8.1 

clear  view  flags 

Section  2.1.2.2.4.2.1 

set  vmodes 

Section  2.1.2.2.4.9.1 

Table  2.3-421:  vision  restore  isu  ext  Information. 


2.3.6.3.2.16  vision_restore_dri ver_blocks 

This  routine  sets  view  flags  and  view  modes,  restoring  the  view  on  the  screen  used  by  the 
driver. 


1  Calls  1 

Function 

Where  Described 

set  view  flags 

Section  2.1.2.2.4.8.1 

set  vmodes 

Section  2.1 .2  2.4.9.1 

Table  2.3-422:  vision_restore_driver_blocks  Information. 
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2.3.6.3.2.17  vision  restore  cmdrs  blocks 


This  routine  sets  view  flag  and  view  modes,  restoring  the  view  on  the  screens  used  by  the 
commander. 


1  Errors  1 

Error  Name 

Reason  for  Error 

unknown  cmdr  state ... 

The  variable  cmdr  state  has  an  unexpected  value. 

Calls 

Function 

Where  Described 

set  view  flaas 

Section  2.1.2.2.4.8.1 

set  vmodes 

Section  2.1.2.2.4.9.1 

Table  2.3-423:  vision  restore  cmdrs  blocks  Information. 


2.3.6.3.2.18  vision_break_gunners_block 

This  routine  clears  view  flag  and  view  mode  bits,  blackening  the  screens  used  by  the 
gunner. 


1  Errors  1 

Error  Name 

Reason  for  Error 

unknown  ounner  state  ... 

The  variable  aunner  state  has  an  unexpected  value. 

Calls 

Function 

Where  Described 

set  view  flaas 

Section  2.1.2.2.4.8.1 

clear  view  flags 

Section  2.1.2.2.4.2.1 

set  vmodes 

Section  2.1.2.2.4.9.1 

Table  2.3-424:  vision_break_gunners_block  Information. 


2.3.6.3.2.19  vision_restore_gu nners^block 

This  routine  sets  view  flag  and  view  mode  bits,  restoring  the  view  on  the  screens  used  by 
the  gunner. 


Errors  1 

Error  Name 

Reason  for  Error 

unknown  gunner  state  ... 

The  variable  gunner  state  has  an  unexpected  value. 

Calls 

Function 

Where  Described 

set  view  flags 

Section  2.1 .2.2.4  8.1 

set  vmodes 

Section  2. 1.2.2. 4.9.1 

fable  2.3-425:  vision_restore_gunners_block  Information. 
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2.3.6.3.2.20  vision_gunner_brow_pad_on 

This  routine  enables  the  integrated  sight  unit  view  of  the  gunner. 


1  Calls  1 

Function 

Where  Described 

set  br  bit 

Section  2.1. 2.2.4. 6.1 

clear  view  flaas 

Section  2.1.2.2.4.2.1 

set  view  flaas 

Section  2.1.2.2.4.8.1 

set  vmodes 

Section  2.1.2.2.4.9.1 

controls_gunner_brow_pad_ 

on 

Section  2.3.2 

Table  2.3*426:  vision_gunner_brow_pad_on  Information. 


2.3.6.3.2.21  vision_gunner_brow__pad_of  f 

This  routine  disables  the  integrated  sight  unit  view  of  the  gunner,  enabling  the  unity  vision 
view  of  the  gunner. 


1  Calls  1 

Function 

Where  Described 

cir  br  bit 

Section  2.1.2.2.4.1.1 

clear  view  flaos 

Section  2.1.2.2.4.2.1 

set  view  flaas 

Section  2.1.2.2.4.8.1 

set  vmodes 

Section  2.1.2.2.4.9.1 

controls  gunner  brow jsad 
off 

Section  2.3.2 

Table  2.3-427:  vlsion_gunner_brow_pad_off  Information. 


2.3.6.3.2.22  vision_commander_brow_pad_on 

This  routine  enables  the  integrated  sight  unit  extension  view  of  the  commander. 


1  Calls  1 

Function 

Where  Described 

set  br  bit 

Section  2.1. 2.2  4.6. 1 

clear  view  flaas 

Section  2.1. 2.2.^  ?.1 

set  view  flaas 

Section  2.1.2.2.;.8.1 

set  vmodes 

Section  2.1.2.2.4.9.1 

controls_commander_brow_p 
ad  on 

Section  2.3.2 

Table  2.3-428:  vision_commander_brow_pad_on  Information. 
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2.3.6.3.2.23  vision_commander_brow_pad_off 

This  routine  disables  the  integrated  sight  unit  extension  view  of  the  commander. 


1  Calls  1 

Function 

Where  Described 

cir  br  bit 

Section  2.1.2.2.4.1.1 

clear  view  flags 

Section  2.1.2.2.4.2.1 

set  view  flags 

Section  2.1.2.2.4.8.1 

set  vmodes 

Section  2.1.2.2.4.9.1 

controls_commander_browj3 
ad  off 

Section  2.3.2 

Table  2.3-429:  vision_commander_brow_pad_off  Information. 


2.3.6.3.2.24  print_br_values 

This  routine  displays  branch  values. 


Internal  Variables 


Internal  Variable 


wd 


vf 


Type 


pointer  to  WORD 


WORD 


Where  Typedef  Declared 


mass  stdc.h 


mass  stdc.h 


Calls 


Function 


get  br  vals 


get  _view  flags 


Where  Described 


Section  2.1.2.2.4.3.1 


Section  2.1.2.2.4.4.1 


Table  2.3-430:  print_br_values  Information. 


2.3.6.3.2.25  get_cmdr_state 

This  routine  returns  the  commander's  view  slate. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

cmdr_sfate 

int 

Normal  end. 

Table  2.3-431:  get_cmdr_state  Information. 
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2.3.6.3.2.26  get_gunner_state 
This  routine  lettmis  the  gunner's  view  state. 


1  Return  Values  1 

Return  Value 

Meaning 

aunner  state 

int 

Normal  end. 

Table  2.3-432:  get_gunner_state  Information. 


2.3.6.3.2.27  get_brow_pad_status 
This  routine  returns  the  brow  pad  status. 


1  Return  Values  1 

Return  Value 

Meaning 

FALSE 

int 

Brow  pad  not  changed. 

TRUE 

int 

Brow  pad  changed. 

Table  2.3-433:  get_brow_pad_status  Information. 


2.3.6.3.2.28  vision_init 

This  routine  initializes  software  for  all  the  vision  blocks. 


1  Internal  Variables  1 

Internal  Variable 

Where  Tvpedef  Declared 

i 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

clear  view  flags 

Section  2.f  .2.2.4.2.1 

set  view  flags 

Section  2.1.2.2.4.8.1 

set  vmodes 

Section  2.1.2.2.4.9.1 

fail  init  failure 

Section  2.5.4.11.2 

Table  2.3-434:  vision  init  Information. 
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2. 3. 6. 3. 3  m2_isu.c 

(./simn^release/src/vehicle/m2/src/m2_isu.c  [m2_isu.c]) 

The  m2_isu.c  CSU  determines  which  reticle  (hi  mag,  lo  mag,  TOW)  is  displayed  in  the 
gunner's  isu  and  gunner's  isu  extension  viewpons. 

Includes: 

"stdio.h" 

"sim_types.h" 

"sim_dfns.h" 

"sim_macros.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"m2_turr_mx.h" 

"m2_cntrl.h" 

"m2_isu.h" 

"pro_sim.h" 

"mun_type.h" 


Defines: 

Symbols  Yaiw 

1jO_MAG_RET  0 

HI_MAG_RET  1 

TOW.RET  2 

NO.RET  3 


int  declarations  and  initialization: 

mag_select_val  =  GN_4X_VAL 
reticle_selected 

ObjectType  declarations 
round_selected 


2. 3. 6. 3. 3.1  isu_init 

This  routine  initializes  the  integrated  sight  unit  (isu). 
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2. 3. 6. 3. 3. 2  isu_siinul 

This  routine  performs  a  tick-by-tick  simulation  of  the  isu. 


1  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

temp 

int 

Standard 

1  Errors  1 

Error  Name 

Reason  for  Error 

isu_simul:  impossible 
reticle  selected  ... 

The  variable  reticle_selected  has  an  unexpected  value. 

1  Calls  1 

Function 

Where  Described 

controls  hi  maa  reticle 

Section  2.3.2 

controls  lo  mao  reticle 

Section  2.3.2 

controls  tow  reticle 

Section  2.3.2 

controls  no  reticle 

Section  2.3.2 

nprintf 

Section  2.1.1.3.1.34.1 

Table  2.3*435:  isu  simul  Information. 


2. 3. 6. 3. 3. 3  isu_gps_mag_12x 

This  routine  sets  magnification  for  gps  to  12x. 

2. 3. 6. 3. 3. 4  isu_gps_mag_4x 

This  routine  sets  magnification  for  gps  to  4x. 

2 . 3 . 6 . 3 . 3 . 5  isu_round_select_25mm 
This  routine  selects  an  M792  round. 


2 . 3 . 6. 3 . 3 . 6  isu_round_seIect_no_round 
This  routine  selects  no  round. 


2. 3. 6. 3. 3. 7  isu  round  select  tow 


This  routine  selects  a  tow  missile. 
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2.3.7  Network  Interactions 

Once  each  frame,  the  simulation  must  process  the  information  coming  to  it  across  the 
SIMNET  LAN  about  other  simulated  vehicles,  weapons  effects,  collisions,  etc.  It  must 
also  send  an  update  packet  on  its  own  status  if  that  has  changed  significandy  in  the  current 
frame. 


Figure  2.3-8:  Structure  of  the  M2  Network  Interactions  CSC. 

The  simulation  host  periodically  informs  other  entities  on  the  network  of  its  current 
location,  orientation,  and  appearance.  If  an  update  in  the  simulator's  appearance  is  to  be 
sent,  libapp  calls  routines  in  m2_network.c  to  fill  in  vehicle-specific  fields.  Routines  are 
called  in  nf2_dust.c  to  determine  what  size  dust  cloud,  if  any,  should  be  reported. 

The  status  of  internal  subsystems  are  reported  every  30  seconds  (for  reconstitution  and  data 
collection  purposes).  Routines  for  sending  this  status  are  found  in  m2_network.c. 

The  simulation  host  also  sends  equipment  status  packets  every  30  seconds,  reporting 
ambient  temperature,  power  supply  voltages,  and  other  hardware  specific  information.  The 
routines  for  reporting  on  hardware  status  are  found  in  the  vehicle  specific  files 
m2_network.c.  This  functionality  is  realized  by  the  following  CSU's: 

m2_network.c 

m2_dust.c 


9U 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


2. 3. 7.1  m2_network.c 

(7simnet/release/srcA^ehicle/m2/m2_network.c  [m2_network.c]) 

Routines  in  this  CSU  are  called  to  update  the  M2’s  appearance  and  the  state  of  its  internal 
systems. 

Includes: 

"stdio.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h'' 

"libnetwork.h" 

"pro_sim.h" 

"pro_mgmt.h" 

"pro_data.h" 

"pro_size.h" 

"status_m2.h" 

"net/network.h" 

"libkin.h" 

"libhull.h" 

"libfaiLh" 

"libturret.h" 

"libapp.h" 

"m2_status.h" 

"m2_elecsys.h" 

"m2_fuelsys.h" 

''m2_ammo.h" 

"m2_engine.h" 

"m2_odom.h" 
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2.3.7. 1.1  send_equipment_status 

This  routine  sends  an  equipment  status  PDU  over  the  network. 


1  Internal  Variables  I 

Internal  Variable 

Type 

Where  Typedef  Declared 

Ddu 

ManaaementPDU 

p  data.h 

pkt 

pointer  to  register 
EquipStatusVariant 

p_mgmt.h 

1  Calls  1 

Function 

Where  Described 

network  aet  simulator  type 

Section  2.1.1.3.1.19.1 

what  is  voKaaei2P 

Section  2.1 .5.2.1 

what  is  voltaael2N 

Section  2.1 .5.2.2 

what  is  voltaaeS 

Section  2.1. 5.2.3 

what  is  temperature 

Section  2.1 .5.2.4 

Section 

Ms  cia  healthy 

Section 

Section 

Section 

■  i  1 1  a  iTJ:!  1  i 

Section 

network_fill_hdr_send_mgmt 

pkt 

Section  2.1.1.3.1.42.7 

PRO  MGMT  EQUIP  STATU 

S  SIZE 

p_assoc.h 

Table  2.3*436:  send_equipment_status  Information. 
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2.3. 7. 1.2 


fill_vehicle_spec_status 


This  routine  fills  in  an  M2  vehicle  specific  status  packet. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

pkt 

pointer  to  register 
VehicleStatusVariant 

p_data.h 

Calls 

Function 

Where  Described 

enaine  aet  max  power 

Section  2.2.6.2.2.14 

electsys_get_hull_battery_vol 

taae 

Section  2.3.6.3.1.26 

electsys_get_turret_backup_ 
battery  voltaae 

Section  2.3.6.3.1.27 

fuel  level  top 

Section  2.3.5.2.10 

fuel  level  bottom 

Section2.3.5.2.9 

ammo_jget_apds_can_quantit 

V 

Section  2.3.5.1.4 

ammo_get_apds_can_ammo 

boxes 

Section2.3.5.1.5 

ammo  aet  hei  can  quantity 

Section  2.3.5. 1.6 

ammojget_hei_can_ammo_b 

oxes 

Section2.3.5.1.7 

ammo_get_apds_stowed_qu 

antitv 

Section  2.3.5.1.8 

ammo_get_hei_stowed_quan 

titv 

Section  2.3.5.1.9 

ammo_get_tow_stowed_qu  a 
ntitv 

Section  2.3.5.1.10 

ammo_get_dragon_stowed_ 

Quantity 

Section  2.3.5.1.11 

ammo  oet  missile  1  val 

Section  2.3.5.1.12 

ammo  oet  missile2  val 

Section  2.3.5.1.13 

launcher  up  status 

Section 

ammo_get_m3_configuration 

val 

Section  2.3.5.1.14 

ramp  down  status 

Section  2.3. 6. 1.3.4 

Table  2.3-437;  fill_vehicle_spec_status  Information. 
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Paramdtar 


pkt 


Parameters 


e 


pointer  to  register 
Vehicle  AppearanceVariant 


Where  Typedef  Declared 


p_sim.h 


Calls 


Functlocn  I  Where  Described 


turretoea^  network  azimuth  Section  2.5.5.2.15 


turret  aet  network  elevation  Section  2.5.5.2.14 


Table  2.3*438:  fill_vehicle_spec_appearance  Information. 

2.3.7. 1 .4  network_process_activation_parameters 

This  routine  processes  the  vehicle's  activation  parameters,  received  from  the  MCC. 


Parameter 


\Em 

irs 


Parameters 


inter  to  VehicleStatus 


Where  Tvoedef  Declared 


status. h 


Internal  Variables 


Internal  Variable 


status 


IB73 


pointer  to 

SIMNET  M2  Status 


Where  Typedef  Declared 


stat  ml.h 


Functiotfl 


fail  set  subsvs 


stall  maintenance  condition 


odom_seUnitiaLdistance_k 

m 


ammo  irnD.  ammo  suppi 


fuel  init  'tanks 


launcher  init  launcher  u 


ramp  inK:  ramp  down 


enoine  init  power 


electsys  init  batteries 


Calls 


Where  Described 


Section  2.5.4.14.2 


Section  2.5.4.26.2 


Section  2.3.2.3.4.3 


Section  2.3.5.1.3 


Section  2.2.5.2.1 


Section  2.3.6.1.4.1 


Section  2.3. 6.1 .3.1 


Section  2.3.6.2.6.12 


Section  2.3.6.3.1.38 


Tabfee  2.3-439:  network_process_activation_parameters  Information. 
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2. 3. 7. 1.5  app_imt 

This  routine  initializes  thresholds. 


1  Errors  1 

Error  Name 

Reason  for  Error 

Network:  couldn't  init 
thresholds 

A  call  to  networkjnitjhresholds  returned  a  zero. 

Calls 

Function 

Where  Described 

network  Initjhresholds 

Section  2.1.1.3.1.66.5 

Table 

2.3-440:  app_init  Information. 

2.3.7. 1.6  veh_spec_activate_time 
This  routine  returns  60. 


I  Return  Values  I 

Return  Value 

Meanina 

60 

int 

N/A 

veh__spec__activate_tinie  Information. 


Table  2.3-441: 
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2. 3. 7. 2  m2_dust.c 

(7simnet/release/sTc/vehicle/m2/src/m2_dust.c  [m2_dust.c] ) 

The  routine  in  this  CSU  is  called  to  determine  the  appearance  of  the  M2’s  dust  cloud. 

2. 3. 7. 2.1  tracks_get_dust_cIoud 

This  routine  determines  the  appear^ce  of  the  M2  Vehicle’s  trailing  dust  cloud.  The  size  of 
the  cloud  is  determined  by  the  vehicle’s  speed,  speed,  and  the  soil  type. 


1  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

speed 

REAL 

Sim  types. h 

soil  type 

int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

vehDustCloudNone 

int 

no  dust  cloud  trails  the  vehicle 

vehDustCloudSmall 

int 

a  small  dust  cloud  trails  the 
vehicle 

vehDustCloudMedium 

int 

a  medium  dust  cloud  trails  the 
vehicle 

vehDustCioudLarge 

int 

a  large  dust  cloud  trails  the 
vehicle 

1  Errors  1 

Error 

Reason  for  Error 

tracks  qet  dust  cloud 

Invalid  soil  type 

1  Calls  1 

Function 

Where  Described 

drivetrain  get  vehicle  speed 

Section  2.3.6. 2.4.8 

Table  2.3-442:  tracks_get_dust_cloud  Information. 
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2.4  Stealth  Vehicle 

Figxire  2.4-1  depicts  the  structure  of  the  Stealth  Vehicle  Software  CSC 


I— kato_maln.c 
S.4.1.1 


kato_cd_fsm.c 

_  kato_failur6.c 

—  kato_ammo.c 

5.4.2.1 

S.4.3.1 

5.4.4.1 

kato  ctl  nis.c 

—  kato  resupp.c 

5.4.22 

5.4.4.2 

kato  ctl  sim.c 

S.4.2.3 

kato_pots.c 

54.2.4 

kato  meter.c 

S.4.2.5 

Stealth 

Vehicle 

Model 

5.4.5 


^  kato_vlslon.c 

5.4.5.1 

^  kato_rotate.c 

5.4.5.2 


U  kato_network.c  ^  kato  attach.c  —  kato  control.c 


Network 

Interactions 

5.4.6 


5.4.6.1 

kato_cinc_llt.c 

5.4.2.Z 

kato_perlph.c 

5.4.2.3 

kato_8lmul.c 

54.2.4 

kato_stubs.c 

5.42.5 


Attach 

Capability 

5.4.7 


5.4.7.t 


5.4.8.1 


^  kato_gunmnLc  k—  Kato_staIo.c 
5.4.7.2  54.8.2 


Figure  2.4-1:  Structure  of  the  Stealth  Vehicle  Software  CSC. 
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The  CSCS  which  constitute  this  CSC  are  as  follows; 

Top  Level  Stealth  Simulation  Software 
Stealth  Controls/Switchology 
Failures 

Munitions  Management 
Stealth  Vehicle  Model 
Networic  Interaction 
Attach  C^ability 
Motion 


2.4.1  Top  Level  Stealth  Simulation  Software 

The  code  required  for  Stealth  simulationis  found  in  this  CSC.  It  contains  one  CSU, 
kato_main.c. 


2. 4. 1.1  kato_main.c 

(/simnet/release/src/vehicle/kato/src/kato_main.c  [kato_main.c]) 

This  file  contains  routines  used  in  the  SIMNET  simulation  of  the  Stealth  Vehicle. 


"simstdio.h" 

"signal.h" 

"sim_macros.h" 

"mass_stdc.h" 

"sim_cig_if.h" 

"pro_sim.h" 

"pro_num.h" 

"fifo_dfn.h" 

"bigwheelh" 

'iibkin.h’' 

"Ubcig.h" 

"bbd.h" 

"libidc.h" 

"libmem.h" 

"librcpair.h" 

"libsusp.h" 

"libsound.h" 

"timers.h" 

"status.h" 

"cmc.h" 

"cmc_status.h" 

"kato.cntrl.h" 

"kato.keybrd.h" 

"kato,  pots.h" 

"kato_resupp.h" 

"kaiJ  ’  ision.h" 

“kuto.  tate.h” 


"ctype.h" 

"sim_dfns.h'' 

"sim_types.h" 

’■dgi_stdg.h" 

"pro_assoc.h" 

"status.h" 

"veh_type.h" 

"fifo.h" 

"libterrain.h" 

"Ubfailh" 

"libmsg.h" 

"libhull.h" 

"libmain.h" 

"libnetwork.h" 

"librva.h" 

"libturret.h" 

"libmap.h" 

"dtad.h" 

"ser_status.h" 

"cmc_timers.h" 

“kato_md_dfn.h” 

"kato_view.h" 

“kato_meter.h" 

"kato_rcpair.h" 

"kato_sound.h" 

"kalo,_status.h" 
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The  following  are  declared: 
debug 

print_overruns 
reboot  on  shutdown 


initial_bbd[] 

quat  dumpO 
exitd 


The  following  are  declared  for  the  '-p'  switch: 
init_activ 
initial_activation 


The  following  is  defined: 
PARS.FILE 


2.4. 1.1.1  print_help 

This  routine  prints  out  data  for  the  Stealth  simulation. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

proqname 

pointer  to  char 

standard 

Table  2.4-1:  print  help  Information. 

9 

2. 4. 1.1. 2  print_vehJogo 

This  routine  prints  a  logo  for  the  Stealth  vehicle. 
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2. 4. 1.1. 3  veh_spec_startup 

This  routine  sets  up  the  network  and  CIG  interfaces  at  startup. 


1  Calls  1 

Function 

Where  Described 

rtc  init  clock 

Section  2.6.16.1.14 

AssocSubscribe 

Section  2.20.1.1.1 

network  aet  net  handle 

Section  2.1.1.3.2.12.1 

network  set  simulator  tvoe 

Section  2.1.1.3.1.53.1 

network  set  vehicle  class 

Section  2.1.1.3.1.54.1 

use  cIq  reconflQ  startup 

cia  set  view  confia  file 

Section  2.1.2.2.2.23.1 

pet  vconfiQ  filet 

Section  2.5.1. 2.2 

map  vehicle  file  read 

Section  2.6.11.5.1 

aet  veh  map  file 

Section  2.5.1. 2.5 

map  read  asid  file 

Section  2.6.11.4.1 

aet  asid  map  file 

Section  2.5.1. 2.4 

map  file  read 

Section  2.6.11.3.1 

aet  ammo  map  file 

Section  2.5.1. 2.6 

keybrd  init 

Section  2. 1.6.4 

Table  2.4-26.4:  veh_spec_startup  Information. 


2. 4. 1.1. 4  veh_spec_idle 

This  routine  is  called  while  the  simulator  is  in  the  IDLE  state. 


1  Calls  1 

Function 

Where  Described 

status  simul 

Section  2. 1.5.4 

keyboard  simul 

Section  2. 1.6.4 

io  simul  idle 

Section  2.1.2.2.5.1.2 

process  activate  request 

Section  2.1.1. 3.2.1. 1 

network  qet  exercise  id 

Section  2.1.1.3.1.16.1 

Table  2.4-3; 


veh_spec_idle  Information. 
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2. 4. 1.1. 5  veh_spec_init 

Order  dependent  initializations  are  performed  for  all  of  the  Stealth’s  subsystems  while  the 
simulator  is  in  the  SIMINIT  state.. 


1  Calls  1 

Function 

Where  Described 

sound  reset 

Section  2. 1.3.4 

status  preset 

Section  2. 1.5.4 

controls  fsm  init 

Section  2.4.2.1 

controls  sim  init 

Section  2.4.2.3 

view  init 

Section  2.1 .2.2.9 

meter  init 

Section  2.4.2 

vision  restore  all  blocks 

Section  2.4.5. 1 

kato  init 

Section  2.4.6.4 

Section  2.4 

aunmnt  init 

Section  2.4.7.2 

controls  edae  init 

Section  2.4 

Section 

confia  DOS  injt2 

Section  2.1.2.2.2.24.2 

kinematics  oet  o  to  h 

Section  2.5.8.2.4 

kinematics  oet  w  to  h 

Section  2.5.8.2.7 

resupply  init 

Section  2.4.4.2 

ciq  init  ctr 

Section  2. 1.2.2. 

Table  2.4-5:  veh_specjnit  Information. 


2.4. 1.1.6  veh_spec_simulate 

This  routine  calls  the  routines  which  simulate  the  various  functins  of  the  Stealth’s 
subsystems  on  a  tick  by  tick  basis. 


1  Calls  1 

Function 

Where  Described 

status  simul 

Section  2. 1.5.4 

keyboard  simul 

Section  2. 1.6.4 

sound  simul 

Section  2. 1.3.4 

controls  simul 

Section  2.4 

view  simul 

Section  2.1. 2.2.9 

meter  simul 

Section  2.4.2.5 

kato  simul 

Section  2.4 

resupply  simul 

Section  2.4.4.2 

Table  2.4-5:  veh_spec_simulate  Information. 
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2. 4. 1.1. 7  veh_spec_stop 


This  routine  is  called  while  the  simulator  is  in  the  SIMSTOP  state.  The  IDC  and  sound 
system  hardware  are  reinitialized,  and  the  vision  blocks  are  broken??? 


1  Calls  1 

Function 

Where  Described 

idc  init 

Section  2.1.4.1.1.24.1 

sound  init 

Section  2.1. 3.4 

vision  break  all  blocks 

Section  2.4.5. 1 

Table  2.4-6:  veh_spec_stop  Information. 


2.4. 1.1.8  veh_spec_exit 


This  routine  is  called  while  the  simulator  is  in  the  SIMEXIT  state.  Simulation  statistics  are 
printed,  and  the  network  connection  is  closed. 


1  Internal  Variables  | 

Internal  Variable 

Type 

Where  Typedef  Declared 

num  ticks 

int 

standard 

1  Calls  1 

■  Function  1 

Where  Described 

Section  2.4.7.1 

■  keyboard  exit  oracefullv 

Section  2. 1.6.4 

1 1 1  u 

Section  2.4.2.5 

timers  aet  current  time 

Section  2.6.3.2.1 

timers  qet  current  tick 

Section  2.6.3.1.1 

timers  elapsed  milliseconds 

Section  2.6.3.10.1 

network  print  statistics 

Section  2.1.1.3.2.16.1 

net  close 

Section  2.20.2.3.1  in  MCC  CSCI  SDD 

Table  2.4-7:  veh_spec_exit  Information. 
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2. 4. 1.1. 9  main 

f 

This  routine  loops  through  the  simulation  of  the  Stealth  vehicle  once  each  frame.The 
generic  simulation  routines  in  “libmain”  are  called  by  this  routine. 

The  parameters  are  parsed: 

case -a 

Request  receive  size  and  request  send  size  are  set,  and  assymetnc  is 
set  on. 

case-b 

Bumper  numbers  are  used. 

case  -B 

Spaceball  tty  is  changed. 

case-c 

Smoothing  is  shut  off. 

case  -d 

Debugging  is  enabled. 

case-e 

The  ethemet  is  closed. 

case-E 

The  exercise  ID  is  set 

case-F 

Not  used 

case  -f 

Not  used. 

case  -g 

CIG  isn't  using  graphics. 

case  -h 

Print  help. 

case-? 

Print  help. 

case  -k 

The  keyboard  is  used. 

case-1 

No  gunner’s  magnification  is  available  for  StealthS. 

case  -n 

Nlos  missile  vehicle  mode  is  enabled. 

case  -o 

Printing  of  oveiruns  is  enabled. 

case  -p 

The  simulator  is  started  in  stand  alone  mode.  The  simulator  acts  as 

• 

if  it  has  received  an  activation  packet  from  the  MCC.  This  segment 
of  code  is  similar  to  that  used  by  the  MCC  for  activationg  a 
simulator. 

case  -r 

Restricted  flight  mode  is  enabled. 

case  -S 

The  netwoik  device  is  set 

case  -s 

Sound  is  disabled. 

case-t 

The  named  database  override  is  used. 

case-T 

DED  name  is  set 

case  -V 

Terrain  verbose  mode  is  enabled. 

case  -u 

Vehicle  freeze  is  disabled. 

case-1 

The  CIGl  mask  and  device  are  set. 

case  -2 

The  CIG2  mask  and  device  are  set. 

• 
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Parameter 


Parameters 


inter  to  char 


where  Typedef  Declared 


standard 


standard 


Internal  Variables 


Internal  VarlabUe 


initial  headin 


Where  Tynedef  Declared 


standard 


standard 


Function 


network  set  exeercise  id 


network  set  net  ttayer 


mam  readoars  ftiie 


set  request  recan/e  size 


set  reouest  send!  size 


set  assymetric  om 


map  set  bumper  status 


controls  set  soacreball  tt 


attach  no  smoottnin 


network_dont_rea1ly_open_u 

ethernet 


cia  not  usino  onaphics 


rint  hel 


keyboard  really  (use 


e  lowres 


state  toggle  missile  state 


et  default  db  reame 


et  default  db  wersion 


state  saf  mode  on 


network  set  network  device 


sound  dont  uso 


cig_use_databafte_Override_ 

named 


a 


set  ded  name 


terrain  verbose  mode  on 


vehicle  freeze  disable 


set  cig  dev 


set  cig  mask 


Sim  state  startup' 


simulation  state  machine 


Where 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Calls 


Described 


2.6.1. 1.1 


2.1.1.3.1.49.1 


2.4.6.1 


2.5.1. 2.1 


2.1.2.2.1.29.1 


2.1.2.2.1.30.1 


2.1.2.2.2.112.1 


2.6.11.4.8 


2.4 


2.4.7.1 


2.1.1.3.2.14.1 


2.1.2.2.1.5.17 


2.4.1 .1.1 


2.1.6.4 


2.1. 2.2.8 


2.4.8.2 


2.5.1.2.15 


2.5.1.2.16 


2.4.8.2 


2.1.1.3.2.12.4 


2. 1.3.4 


2.1.2.2.1.16.1 


Section  2.1 .2.2.1. 8.2 


Section  2.5.11.9.1 


Section  2.1.2.2.1.26.1 


Section  2.1.2.2.2.114.1 


Section  2.3.1. 1.5 


Section  2.5.1.1.13 


Table  2.4-K;  main  Information. 
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2.4.1.1.10  reconstitute_vehicle 

This  routine  reactivates  the  Stealth. 


1  Calls  i 

Function 

Where  Described 

vehicle  restart 

Section  2.3.19.1.7 

Table  2.4-9:  reconstitute_vehicle  Information. 
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2.4.2  Stealth  Controls/S witchology 

Low  level  controls  handling  is  accomplished  with  this  CSC,  which  consists  of  the 
following  CSU’s. 

kato_cd_fsm.c 

kato_ctl_nls.c 

kato_cd_sim.c 

2.4.2. 1  kato_ctl  fsm.c 

(/simnet/reiease^/vehicle/kato/src/kato_ctl_fsm.c  [kato_ctl_fsm.c] ) 

This  CSU  provides  the  finite  power  state  controls  interface  for  the  Stealth  Vehicle. 


Includes: 

"stdio.h" 

"sim_types.h" 

"sim_dfns.h" 

"libidc_dfn.h" 

"libmem.h" 

"libmem_dfn.h" 

"libnetwork.h" 

"kato.cntrlh" 

"kato_ctl_df.h" 

"kato_hard.h"  if  USE.SPACEBALL  not  defined 

"kato_soft.h" 

int  declarations: 

controls_status 

controls_failure_val 

controls_failure_edge 

Procedure  declarations: 

controls_sim_next_state() 

controls_lamp_init() 


2. 4. 2. 1.1  controls_fsm_init 

This  routine  initializes  controls_status,  controls_failure_val,  and  controls_failure_edge. 
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2.4.2. 1.2  controls_simul 

This  routine  is  called  during  the  Simutation  state. 


1  Errors  1 

Error  Name 

Reason  for  Error 

CONTROLS;  controls_simul: 
Impossible  control  state 

The  variable  controls_status  has  an  unexpected  value. 

1  Calls 

Function 

Where  Described 

controls  sim  next  state 

Section  2.4.2.1.10 

nprintf 

Section  2.1.1.3.1.34.1 

Table  2.4-*10:  controls  simul  Information. 


2. 4. 2. 1.3  controls_power_status 

This  routine  returns  controls  status. 


1  Return  Values  1 

Return  Value 

Type 

Meanina 

controls  status 

int 

status  of  the  controls 

Table  2.4-11:  controIs_power_status  Information. 


2 . 4 . 2 . 1 . 4  controls_break_controls 

This  routine  causes  the  controls  to  fail. 


1  Errors  1 

1  Error  Name 

Reason  for  Error 

1  DAMAGE:  controls  broken 

This  routine  was  called  with  controls  failure  val  ==  OFF. 

Calls 

Function 

Where  Described 

nprintf 

Section  2.1.1.3.1.34.1 

Table  2.4-12:  controls  break  controls  Information. 
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2. 4. 2.1. 5  condrols  restore  controls 


This  icmaine  restones  controls. 


Functlom 


controls  (wno  init 


controls  ftsm  init 


controls  siim  init 


controls  edae  init 


Calls 


Where  Described 


Section  2.4.2.1.9 


Section  2.4.2.1.1 


Section  2.4.2.2 


Section  2.4.2.1.8 


Table?  2.4>13:  controls  restore  controls  Information. 


2 .4 . 2 . 1. 6  comtrols_failure_status 

This  rou^e  retumss  the  controls  failure  status. 


Return  Value 


controls  failure  val 


I  on 


Return  Values 


Meanin 


failure  status 


TaGile  2.4>14:  controls  failure  status  Information. 


2. 4. 2. 1.7  con4rols_edges_clear 
This  routine  clears  edges. 

2.4.2. 1.8  coiiHtrols_edge_init 

This  routine  calls  G«>ntrols_edges_clear  to  initialize  edges. 


Functlom 


controls  edaes  clear 


Calls 


Where  Described 


Section  2.4.2.1.7 


Table  2.4*15:  controls_edge_init  Information. 


2. 4. 2. 1.9  conjtrolsJamp_init 

This  routine  calls  c2ontrois  ..view_ind_init  only  if  USE_SPACEBALL  is  not  defined. 


Function 


controls  view  ind  imt 


Calls 


Where  Described 


Section  2.4 


Table  2.4-16;  control.s_lamp_init  Information. 
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2.4.2.1.10  controls  sim  next  state 


1  Calls  1 

Function 

Where  Described 

controls  sim  routines 

Section  2.4 

controls  sim  off 

Section  2.4 

Table  2.4-17:  controls_sini_next_state  Information. 


2. 4. 2. 2  kato_ctl  nis.c. 

(/simnet/telease^rc/vehicle/kato/src/kato_ctl_nls.c  [kato_ctl_nls.c]) 

This  file  is  not  implemented  in  Version  6.6  of  the  software. 

2. 4. 2. 3  kato_ctl  sim.c 

(/simnet/release^/vehicle/kato/src/kato_ctl_sim.c  [kato_ctl_sim.c]) 

The  Stealth’s  controls  interface  is  provided  in  part  by  this  CSU. 

2. 4. 2. 4  kato  pots.c 

(/simnet/reIease/src/vehicle/kato/src/kato_pots.c  [kato_pots.c]) 

This  CSU  provides  modelling  for  Stealth’s  potentiometers.  Routines  in  this  file  translate 
hex  potentiometer  values  between  00  and  FF  into  real  values  and  call  the  appropriate 
subsystems  with  these  values. 

2. 4. 2. 5  kato  meter.c 

(/simnetATeiease/sic/vehicle/kato/src/kato_meter.c  [kato_meter.c] ) 

This  CSU  models  the  Stealth’s  meters.  The  appropriate  values  are  set  by  routines  in  this 
file. 
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2.4.3  Stealth  Failures 

Stealth  vehicle  failures  are  modelled  by  routines  in  this  CSC.  These  routines  are  found  in  a 
single  CSU,  kato_failure.c 

2. 4. 3.1  kato  failure.c 

(/simnet/telease/sic/vehicle/kato/sic/kato.failure.c  [kato_failure.c]) 

This  file  is  a  stub  in  anticipation  for  future  use. 

2.4.4  Munitions  Management 

Two  CSU’s  comprise  this  CSC,  kato_ammo.c  and  kato_resupp.c. 

2.4.4. 1  kato_ammo.c 

(/simnel/release/src/vehicleAmto/src/kato_ammo.c  [kato_ammo.c] ) 

This  file  is  not  implemented  in  Version  6.6  of  the  software. 

2. 4. 4. 2  kato  resupp.c 

(/sininet/reIease/src/vehicle/kato/src/kato_resupp.c  [kato_resupp.c] ) 

This  file  is  not  implemented  in  Version  6.6  of  the  software. 


2.4.5  Stealth  Vehicle  Model 

The  Stealth’s  subsystems  are  modelled  by  routines  in  this  CSC.  CSU’s  required  are  as 
follows. 

kato_vision.c 

kato_rotate.c 

2.4.5. 1  kato_vision.c 

(/simnet/release/src/vehicle/kato/src/kato_vision.c  [kato_vision.c]) 

The  routines  which  control  the  state  of  the  viewports  are  found  in  kato_vision.c.  The 
routines  break  the  viewports  (turn  them  off)  and  fix  them  by  toggling  bits  in  libvflags. 

2. 4. 5. 2  kato  rotate.c 

(/simnet/release/src/vehicle/kato/src/kato_rotate.c  [kato_rotate.c]) 

This  CSU  provides  routines  which  call  librotate.  They  provide  the  rotation  functions  for 
the  Stealth  Vehicle. 
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2.4.6  Network  Interactions 

The  Stealth  Vehicle  has  a  unique  relationship  with  the  Plan  View  Display  System  on  the 
SIMNET  network.  Commands  to  move  the  position  of  the  Stealth  on  the  terrain,  attach  the 
Stealth  to  a  specific  vehicle,  or  to  change  the  Stealth's  exercise  ID  are  all  available  through 
the  use  of  the  Stealth  Protocol. 

The  CSU's  that  make  up  this  CSC  are  as  follows: 

kato_network.c 

kato_cmc_flt.c 

kato_periph.c 

kato_simul.c 

kato_stubs.c 

2.4.6. 1  kato_network.c 

(/simnet/reiease/src/vehicle/kato/src/kato_network.c  [kato_network.c]) 

When  a  Stealth  Protocol  packet  is  received  from  the  network,  the  correct  routines  are  called 
from  kato_network.c. 

2. 4. 6. 2  kato_cmc_flt.c 

(/simnet/release/sic/vehicle/kato/src/kato_cmc_flLc  [kato_cmc_flt.c]) 

This  file  contains  routines  which  handle  the  cmc  card. 

2. 4. 6. 3  kato  periph.c 

(/sitnnet/reIease/src/vehicle/kato/src/kato_periph.c  [kato_periph.c]) 

Routines  in  this  CSU  set  up  the  network  and  card  to  look  for  data  packets  for  the  PVD  and 
the  p2p  protocol. 

2. 4. 6. 4  kato  simul.c 

(/simnet/reIease/src/vehicle/kato/src/kato_simul.c  [kato_simul.c] ) 

This  CSU  calls  Stealth  specific  simulation  routines  and  initializes  them. 

2. 4. 6. 5  kato_stubs.c 

(/sininetAelease/src/vehicle/kato/src/kato_stubs.c  [kato_stubs.c]) 

This  CSU  contains  a  list  of  functions  which  are  stubbed  out  for  the  Stealth.  It  is  necessary 
for  compilation  purposes,  but  provides  no  functionality. 
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2.4.7  Attach  Capability 

The  Stealth  Vehicle  is  capable  of  attaching  to  another  vehicle  by  searching  the  list  of  local 
vehicles  for  the  one  either  selected  by  the  PVD,  or  indicated  by  a  trigger  press.  The 
factions  in  these  files  search  the  vehicle  list,  check  for  the  closest  vehicle  to  the  current 
Ime  of  sight,  and  keep  track  of  the  vehicle  ID  of  the  attached  vehicle.  This  functionality  is 
realized  by  the  following  two  CSU's,  kato_attach.c  and  kato_gunmnt.c. 

2.4. 7.1  kato  attach.c 

(/sininetAeIease/src/vehicle/kato/src/kato_attach.c  [kato_attach.c]) 

2. 4. 7. 2  kato_guninnt.c 

(/simnet/telease/src/vehicleAcato/src/kato_gunmnt.c  [kato_gunmnt.c] ) 


2.4.8  Motion 

The  Stealth  Vehicle  has  two  independent  flight  modes  (Free  Fly,  and  Terrain  Hug)  and  four 
attached  modes  (Tether,  Orbit,  Compass,  and  Mimic).  Basic  inputs  from  the  Spaceball 
controUer  are  used,  in  conjunction  with  position  and  rotation  information  from  the  attached 
vehicle,  to  synthesize  the  Stealth  Vehicle’s  new  position  and  orientation.  This  functionality 
is  realized  by  the  following  CSU's:  kato_control.c  and  kato_state.c. 

2.4.8. 1  kato  control.c 

(/simnet/reIease/src/vehicleAcato/src/kato_control.c  [kato_control.c]) 

The  algorithms  which  control  the  motion  of  the  Stealth  Vehicle  in  each  of  those  modes  are 
in  this  CSU, 

2. 4. 8. 2  kato  state.c 

(/simnet/reIease/src/vehicle/kato/src/kato_state.c  [kato_state.c]) 

Information  regarding  the  current  state,  and  transitions  into  other  states  are  maintained  in 
this  CSU. 
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2.5  Vehicle  Libraries 


The  following  figure  shows  the  structure  of  the  Vehicle  Libraries  CSC.  These  libraries  are 
used  in  the  vehicle  simulation.  Functions  provided  include  the  following:  ballistics 
modelling,  missile  modelling,  failures  and  repairs  simulation,  network  interactions,  as  well 
as  the  main  simulation  steps. 


Figure  2.5-1:  Vehicle  Libraries  CSC. 
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The  following  CSU's  are  components  of  this  CSC: 

libmain 

Ubball 

libmissile 

libfail 

libtuiTCt 

libsusp 

libdyn 

Ubhull 

libkin 

libbigwheel 

libteiiain 

librva 

librva_util 

Hbfilter 

libin:q)acts 

libq)p 

libnear 

librotate 

libupdate 
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2.5.1  libmain 

(./simnetAelease/src/vehicle/libsrc/libmain  [libmain]) 

In  the  SIMNET  vehicle  simulations,  the  main  simulation  loop  is  found  in  libmain.  This 
loop,  executed  once  each  frame,  invokes  generic  functions  to  perform  tasks  common  to  the 
Ml,  M2,  and  Stealth  simulation. 

2. 5. 1.1  main.c 

(./simnet/rclease/sic/vehicle/libsTc/libmain/main.c) 

This  file  contains  all  of  the  generic  simulation  routines  including  the  main  simulation  loop. 


"stdio.h" 

"clock.h" 

"signal.h" 

"sys/mpadvise.h" 

"sim_dfns.h" 

"sim_macros.h" 

"sim_types.h 

"mass_stdc.h" 

"dgLstdg.h" 

"sim_cig_if.h" 

"rtc.h" 

"fifo_dfn.h" 

"fifo.h" 

"bigAvheel.h" 

"libterrain.h" 

"libkin.h" 

"libfailh" 

"libcig.h" 

:bbd.h" 

"libhuU.h" 

"Ubidc.h" 

"libmem.h" 

"libmain.h" 

"libnetwork.h" 

"librepair.h" 

"librva.h" 

"libsusp.h" 

"libturret.h" 

"libsound.h" 

"libimps.h" 

"timers.h" 

"dtad.h" 

"status.h" 

"ser_status.h" 


-if  CLOCK  is  defined 

-  if  CLOCK  is  defined 

-  Masscomp  only 

-  Masscomp  only 
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The  foIkRwing  are  declared: 

cSDck_space  -  if  OXICK  is  defined 

c^ock  -  if  CLOCK  is  defined 

sim_state 

neboot_on_shutdown 

u!iitial_bbdQ 

c^g_startup_func 

&rst_firame 

eKit_gracefully() 

eacitO  -  for  non-Butterfly  machines 

The  follo»wing  simulation  states  are  defined: 

SIM_STARTUP_STATE 

S«M_IDLE_STATE 

SiM_SIMINIT_STATE 

SEM.SIMULATE.STATE 

SIM_SIMSTOP_STATE 

S1M_SIMEXIT_STATE 

2.5.1.1>1  enter_gracefully 

This  routine  enters  the  simulation.  The  simulator  is  put  into  the  idle  state,  and  the  vehicle 
logo  is  printed  on  the  viewport 


1  Calls  1 

Functlom 

Where  Described 

Sim  state  idle 

Section  2.5.1. 1.6 

print  veh  Ioqo 

Section  2.2.1. 1.2 

Table  2.5-1:  enter_gracefully  Information. 

2. 5. 1.1. 2  exit_gracefully 

This  routine  exits  the  simulation.  The  simulator  is  put  into  the  simexit  state,  and  a 
deactivate  packet  is  sent 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

reboot 

int 

Standard 

Calls 

FunctlOiO 

Where  Described 

Sim  state  simexit 

Section  2.5.1.1.10 

send  deactivate  pkt 

Section  2.1.1.3.1.10.1 

Table  2.5-2:  exlt_gracefully  Information. 
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2.5. 1.1.3  activate_simulation 

This  routine  activates  the  simulation.  The  simulator  is  put  into  the  siminit  state. 


1  Calls  1 

Function 

Where  Described 

Sim  state  siminit 

Section  2.5.1 .1.7 

Table  2.5'3:  activate  simulation  Information. 


2. 5. 1.1. 4  (ieactivate_simulation 

This  routine  deactivates  the  simulation.  The  simulator  is  put  into  the  simstop  state. 


1  Calls  1 

Function 

Where  Described 

Sim  state  simstop 

Section  2. 5. 1.1. 9 

Table  2.5-4:  deactivate  simulation  Information. 


2. 5. 1.1. 5  sim_state_startup 

This  routine  sets  the  simulation  state  to  SIM_STARTUP_STATE. 

2.5. 1.1.6  sim_state_idle 

This  routine  sets  the  simulation  state  to  SIM_1DLE_STATE. 

2.5. 1.1.7  sim_^state_siminit 

This  routine  sets  the  simulation  state  to  SIM_SIMINIT_STATE. 

2. 5. 1.1. 8  sim_state_simulate 

This  routine  sets  the  simulation  state  to  SIM_SIMULATE_STATE. 

2. 5. 1.1. 9  sim_state_simstop 

This  routine  sets  the  simulation  state  to  SIM_SIMSTOP_STATE. 

2.5.1.1.10  sim_state_simexit 

This  routine  sets  the  simulation  state  to  SIM_SIMEXIT_STATE. 
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2.5.1.1^11  siin_state_simulating 


This  routiitne  returns  TRUE  if  the  simulator  is  in  the  simulate  state  and  returns  FALSE 
otherwise. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

TRUE 

int 

is  in  simulation  state 

FALSE 

int 

is  not  in  simulation  state 

Table  2.5-5:  sim_state_simulating  Information. 
2.5.1.1.12  sim  state  sounds  denied 


This  routines  returns  FALSE  if  the  simulator  is  in  simulate  state  and  the  sound  system  is 
disabled,  atnd  retiuns  TRUE  otherwise. 


1  Return  Values  I 

Return  value 

Meaning 

TRUE 

int 

is  not  in  simulation  state 

FALSE 

int 

is  in  simulatbn  state  -  turn 
sounds  off 

Table  2.5-6:  sim_state_sounds_denied  Information. 

2.5.1.1.13  simulation_state_machine 

This  is  the  primary  routine  in  this  module.  It  is  called  by  the  primary  simulation  routines  in 
vehicle  specific  code.  For  each  simulation  state,  a  given  set  of  tasks  is  performed. 

SIM_STAIRTUP_STATE; 

This  state  ks  entered  once  at  startup.  The  simulator  hardware  and  the  hull  are  initialized. 
Vehicle  sp^ecific  startup  routines  are  called,  and  the  simulator  is  put  into 
SIM_IDLE_STATE. 

SIM_IDLE_STATE; 

The  simulafior  is  waiting  for  activation.  Timers  are  started,  and  vehicle  specific  routines  are 
called. 

SIM_SIMINIT..STATE: 

This  state  as  entered  once  per  activation.  The  simulation  is  activated,  and  the  CIG  is  set  up. 
Turret,  impacts,  repairs,  and  RVA  are  initialized,  and  the  simulator  is  put  into 
SIM_SIMT,.JLATE_STATE. 

SIM_SIMIJL.ATE_STATE- 

The  simuldtioii  i .  carried  out  once  per  tick.  Vehicle  specific  simulation  routines  as  well  as 
failures,  kmematics,  turret,  repairs  network,  and  I/O  simulation  routines  are  called. 
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SIM_SIMSTOP_STATE: 

This  state  is  entered  once  per  deactivation.  Vehicle  specific  stop  routines  are  called.  Hull 
and  repairs  are  uninitializ^,  the  CIG  is  stopped,  and  the  simulaor  is  put  into 
SIM_IDLE  STATE. 


SIM_SIMEXIT_STATE: 

This  state  is  entered  once  as  the  simulation  is  exited.  Hardware  is  uninitialized  and  shared 
memory  is  fieed.  Vehicle  specific  routines  are  called. 


Calls 

Function 

Where  Described 

bbd  init 

Section  2.1.5.1.11.1 

dtad  init 

Section  2.1.4.2.1.10.2 

mem  assian  shared  memory 

Section  2.6.12.2.1 

ser  heartbeat  init 

Section  2.6.7.2.2 

idc  in'it 

Section  2.1.4.1.1.24.1 

sound  init 

Section  2.1. 3.2.4 

statusjnit 

Sections  2.1. 5.2  m1_status.c,  2.1. 5.3  m2_status.c,  and 
2.1.5.4kato  status.c 

timers  init 

Section  2.6.3.8.1 

potsjnit 

Sections  2.2.2.3.2  mljjots.c,  2.3.2.1.4  m2jpots.c,  and 
2.4.2.4  kato  DOtS.C 

repare 


buffer  setu 


synchronize 


repair  uninit 


hull  init 


CIO  sto 


network  init 


network_canJ_really_use_ne 

twork 


filter  init 


network_use_network_handl 

es 


rva  setu 


et  priority  list  file 


Sim  state  idie 


veh  spec  startu 


timers  simul 


veh  spec  idle 


init  ballistics  buffer 


idc  reset 


veh  spec  init 


impacts  init 


turret  init 


timers  init  starttime 


nra  init 


buffer  reset 


ciQ  spec  init 


fail  init 


Sim  state  simulate 


Section  2.1. 2.2.1. 6.1 


Section  2.1.2.2.2.16.1 


Section  2.1.2.2.1.13.1 


Section  2.5.4.19.2 


Section  2.5.9.1.1 


Section  2.1.2.2.1.12.1 


Section  2.1.1.3.2.^2.3 


Section  2.1.1.3.2.27.1 


Section  2.5.14.7.1 


Sections  2.2.7.1  ml_network.c,  2.3.7. 1  m2_network.c,  and 
2.4.6. 1  kato  network.c 


Section  2.5.12.25.1 


Section  2.5.1.2.10 


Section  2.5.1. 1.6 


Section  2.2.1. 1.3,  2.3.1. 1.3,  and  2.4.1. 1.3 


Section  2.6.3.15.1 


Section  2.2.1. 1.4,  2.3.1. 1.4.  and  2.4.1. 1.4 


Section  2.1.2.2.2.14.1 


Section  2.1.4.1.1.24.4 


Section  2.2.1. 1.5,  2.3.1. 1.5.  and  2.4.1. 1.5 


Section  2.5.15.1.1 


Sections  2.2.6. 1.1  ml  turret.c  and  2.3. 6.1.1  m2  turret 


Sections  2.2.4.2.3  and  2.3.4.2.3 


Section  2.6.3.16.1 


Section  2.5.12.22.1 


Section  2.1.2.2.2.15.1 


Section  2.1.2.2.6.7 


Section  2.2.4.1.1  and  2.3.4.1.1 


Section  2.5.1. 1.8 
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rtc  start  time 

Section  2.6.16.1.2 

bbd  bit  out 

Section  2.1. 5.1 .4.1 

timers  simul 

Section  2.6.3.15.1 

rtc  stOD  time 

Section  2.6.16.1.3 

fail  simul 

Section  2.5.4.13.1 

veh  spec  simulate 

Section  2.2.1. 1.6.  2.3.1. 1.6.  and  2.4.1. 1.6 

kinematics  sirrxjl 

Section  2.5.8.6.1 

turret  simul 

Sections  2.2.6.1.1  ml  turret.c  and  2.3.6.1.1  m2  turret.c 

repair  simul 

Sections  2.2.4.2.2  amd  2.3.4.2.2 

net_simul 

Sections  2.2.7.1  m1_network.c,  2.3.7.1  m2_network.c,  and 
2.4.6.1  kato  network.c 

k)  simul 

Section  2.1.2.2.5.1.1 

veh  spec  stop 

Section  2.2.1. 1.7.  2.3.1. 1.7.  and  2.4.1. 1.7 

hull  uninit 

Section  2.5.9.1.2 

sound  reset 

Section  2.1. 3.2.7 

cio  uninit 

Section  2.1.2.2.1.14.1 

dtad  uninit 

Section  2.1.4.2.1.11.1 

bbd  uninit 

Section  2.1.5.1.16.1 

veh  spec  exit 

Section  2.2. 1.1. 8 

mem  free  shared  memorv 

Section  2.6.12.1.2 

Table  2.5-7:  simulation  state  machine  Information. 
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2.5. 1.2  read  pars.c 

(ysimnet/reTease/src/vehicle/libsn^bniain/read_pars.c) 

This  file  contains  routines  for  reading  parameter  files.  It  allows  one  to  specifiy  vehicle 
specific  file  names  in  a  parameter  file,  such  as  the  default  database  name,  the  default  ded 
name,  and  file  names  for  the  mapping  files. 

Includes; 

”stdio.h" 

"simstdio.h" 

basic.h" 

The  following  are  declared: 
altemate_pars_file[80] 
vconfig_filel[80] 
vconfig_file2[80] 
asid_map_file[80] 
veh_map_file[80] 
ammo_map_&e[80] 
sdamage_file[80] 
thresh_file[80] 
idle_filter_file[80] 
sim_filter_file[80] 
priority_list_file[80] 
register_file[80] 
devices_file[80] 
calib_file[80] 

default_db_namerTerrainNameLength] 

default_db_version 

ded_override[32] 

db_override[32] 

constatus_file[80] 
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2.5. 1.2.1  main_read_pars_file 

This  routine  reads  the  parameter  file  specified  by/n. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

fn 

pointer  to  char 

Standard 

Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

strtokO 

pointer  to  char 

Standard 

fD 

pointer  to  FILE 

Standard 

slSOl 

char 

Standard 

str 

pointer  to  char 

Standard 

1  Calls  1 

Function 

Where  Described 

main  read  pars  file 

Section  2.5.1 .2.1 

cig_use_database_override_ 

named 

Section  2.1.2.2.1.16.1 

set_ded_name 

Section  2.1. 2.2.1. 8.2 

Table  2.5-8;  main_read_pars_file  Information. 


2.5. 1.2.2  get_vconfig_fiIel 


This  routine  returns  a  pointer  to  a  character  string,  vconfigjilel ,  which  represents  the  file 
name. 


1  Return  Values  I 

Return  Value 

Meaning 

vconfigjilel 

pointer  to  char 

represents  vconfig  filel  file 
name 

Table  2.5-9:  get_vconfig_filel  Information. 

2.5. 1.2.3  get_vconfig_file2 

This  routine  returns  a  pointer  to  a  character  string,  \configJile2,  which  represents  the  file 
name. 


1  Return  Values  I 

Return  Value 

Meaning 

vconfigJile2 

pointer  to  char 

represents  vconfig  file2  file 
name 

Table  2.5-10:  get_vconfig_rile2  Information. 


i 

I 


944 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


2.5. 1.2.4  get_asid_inap_file 

This  routine  returns  a  pointer  to  a  character  string,  asidjnapjile,  which  represents  the  file 
name. 


1  Return  Values  | 

Return  Value 

Type 

Meanina 

asid  map  file 

pointer  to  char 

represents  asid  map  file  name 

Table  2.5-11:  get_asid_map_file  Information. 

2.5. 1.2c, 5  get_veh_map_file 

This  routine  returns  a  pointer  to  a  character  string,  vehjmp  Jile,  which  represents  the  file 
name. 


1  Return  Values  | 

Return  Value 

Meanina 

veh_mapjile 

pointer  to  char 

represents  vehicle  mapping 
file  name 

Table  2.5-12:  get_veh_map_rile  Information. 

2.5. 1.2.6  get_ammo_map_file 

This  routine  returns  a  pointer  to  a  character  string,  ammo  map  Jile,  which  represents  the 
file  name. 


1  Return  Values  | 

Return  Value 

Type 

Meaning 

ammo_map_file 

pointer  to  char 

represents  ammo  map  file 
name 

Table  2.5-13:  get_ammo_map_file  Information. 

2. 5. 1.2. 7  get_sdamage_file 

This  routine  returns  a  pointer  to  a  character  string,  sdamagejle,  which  represents  the  file 
name. 


1  Return  Values  | 

Return  Value 

Type 

Meaning 

sdamaae  file 

pointer  to  char 

represents  sdamage  file  name 

Table  2.5-14:  get_sdamage_file  Information. 
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2.5. 1.2.8  get_tJiresh_file 

This  routine  returns  a  pointer  to  a  character  string,  thresh  Jile,  which  represents  the  file 
name. 


1  Return  Values  I 

Return  Value 

Tvne 

Meanina 

thresh  file 

pointer  to  char 

represents  thresh  file  name 

Table  2.5-15:  get_thresh_file  Information. 

2.5. 1.2.9  get_i<lle_filter_file 

This  routine  returns  a  pointer  to  a  character  string,  idle  JilterJile,  which  represents  the  file 
name. 


1  Return  Values  I 

Return  Value 

Meanina 

idle  filter  file 

pointer  to  char 

irepresents  die  filter  file  name 

Table  2.5>16:  get_idle__filter_file  Information. 

2.5.1.2.10  get_priority_list_file 

This  routine  returns  a  pointer  to  a  character  string,  priority  Jist  Jile,  which  represents  the 
filename. 


1  Return  Values  I 

Return  Value 

priorityjist 

pointer  to  char 

represents  priority  list  file 
name 

Tabde  2.5-17:  get_priority_list_file  Information. 

2.5.1.2.11  get_register_file 

This  routine  returns  a  pointer  to  a  character  string,  register  Jle,  which  represents  the  file 
name. 


1  Return  Values  I 

Return  Value 

Type 

Meanina 

reaister  file 

pointer  to  char 

pointer  to  register  file  name 

Table  2.5-18:  get_register_rile  Information. 
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2.5.1.2.12 


get_device_file 


This  routine  returns  a  pointer  to  a  character  string,  device  Jile,  which  represents  the  file 
name. 


1  Return  Values  I 

Return  Value 

Meanina 

device  file 

pointer  to  char 

represents  device  file  name 

Table  2.5-19:  get_device_file  Information. 

2.5.1.2.13  get_calib_file 

This  routine  returns  a  pointer  to  a  character  string,  calib  Jile,  which  represents  the  file 
name. 


1  Return  Values  | 

Return  Value 

Meanina 

calibjile 

pointer  to  char 

represents  calibration  file 
name 

Table  2.5-20:  get_calib_file  Information. 
2.5.1.2.14  get__sim__filter_file 


This  routine  returns  a  pointer  to  a  character  string,  simjilter  Jile,  which  represents  the  file 
name. 


1  Return  Values  | 

Return  Value 

Meaning 

Sim  filter  file 

pointer  to  char 

represents  sim  filter  file  name 

Table  2.5-21:  get_sim_filter_file  Information. 

2.5.1.2.15  get_default_db_name 

This  routine  returns  a  pointer  to  a  character  string,  default  db  name,  which  represents  the 
file  name. 


1  Return  Values  | 

Return  Value 

Meaning 

default_db_name 

pointer  to  char 

represents  default  database 
name 

Table  2.5-22:  get_default_db_name  Information. 
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Return  Values 

Return,  Value  |Tvpe  [Meaning 

default  gdb  vtfsion _  unsigned  short _ default  database  version 


Table  2.5-23:  get_default_db_version  Information. 
2.S.1..2.17  get_ded_override 

This  iDiutine  returns  a  pointer  to  a  character  string,  ded  override. 


1  Return  Values  | 

Return  Value 

Meaning 

ded  ovorride 

pointer  to  char 

ded  override 

Table  2.5-24:  get_ded_override  Information. 


2.5.1  ..2. 18  get_db_override 
This  imitine  returns  dh  override. 


1  Return  Values  I 

Return  Value 

Meaning 

db  override 

pointer  to  char 

data  base  override 

Table  2.5-25:  get_db_override  Information. 


2.5.1.2.19  get_constants_file 

This  ixwitine  returns  a  pointer  to  a  character  string,  constants  Jile,  which  represents  the  file 
name. 


1  Return  Values  I 

Return:  Value 

Type 

Meaning 

constantsjile 

pointer  to  char 

represents  constants  file 
name 

Table  2.5-26:  get_constants_rile  Information. 
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2.5.1.2.20  print_pars_riles 

This  routine  prints  each  of  the  parameter  files. 


Calls 


Function 

Where  Described 

aet  vconfia  filet 

Section  2.5.1. 2.2 

aet  vconfia  file2 

Section  2.5.1. 2.3 

aet  asid  map  file 

Section  2.5.1. 2.4 

aet  veh  map  file 

Section  2.5.1. 2.5 

aet  ammo  map  file 

Section  2.5.1. 2.6 

aet  sdamaae  file 

Section  2.5.1. 2.7 

aet  thresh  file 

Section  2.5.1. 2.8 

aet  Idle  filter  file 

Section  2.5.1. 2.9 

aet  Sim  filter  file 

Section  2.5.1.2.14 

aet  priority  list  file 

Section  2.5.1.2.10 

aet  reaister  file 

Section  2.5.1.2.11 

aet_default  db  name 

Section  2.5.1.2.15 

aet  default  db  version 

Section  2.5.1.2.16 

aet  ded  override 

Section  2.5.1.2.17 

aet  db  override 

Section  2.5.1.2.18 

aet  constants  file 

Section  2.5.1.2.19 

Table  2.5*27:  print_pars_files  Information. 


949 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


2.5.2  libball 

(./simnetAelease/src/vehicle/libsrc/libball  [libball] ) 

Libball  is  used  to  convert  data  from  the  given  firing  tables  containing  range,  time  of  flight, 
and  superelevation  data  into  ballistics  tables  containing  range,  distance  away,  and  distance 
down  on  a  30  Hz  cycle.  This  ballistics  table  is  sent  to  the  CIG  at  initialization. 

2.5.2. 1  ball  caic.c 

(./simnet/rSease/src/vehicle/libsrc/libball/ball_calc.c) 

Inlcudes; 

"stdio.h" 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 


Defines: 

MAX_NUMBER_ITERATIONS 

CONVERGENCE.CRTTERION 
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2. 5. 2. 1.1  ballistics_calc_time 

This  routine  computes  and  returns  the  time  required  for  a  certain  type  of  ammunition  to  fly 
the  specified  range.  The  routine  uses  the  Newton-Raphson  method  of  iteration  to  solve  for 
time  given  the  range  and  the  function  R  =  f(t).  On  call,  the  function  is  passed  pointers  to 
arrays  containing  tiie  polynomial  coefficients  for  the  functions  xb  =  f(t),  yb  =  f^(t),  and  the 
value  of  the  range  desired 

Parameters  are  represented  as  follows: 
xb_coefficients  -  polynomial  coefficient 

yb  coefficients  -  polynomial  coefficient 

desired  range  --  desired  range 


Parameters 


Parameter 


xb_coefficients 


yb_coefficients 


desired_range 


\wm 


pointer  to  REAL 


pointer  to  REAL 


Where  Tvoedef  Declared 


/simnet/common/include/glob 
al/sim  tvpes.h 


/simnet/common/include/glob 
al/sim  tvpes.h 


/simnet/common/include/glob 
al/sim  tvpes.h 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

time 

register  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

current_xb 

register  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

current_yb 

register  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

current_xb_prime 

register  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

current_ybj3rime 

register  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

current_range 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

cu  rrent_range  J3rime 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

error 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

standard 


Return  Value 


time 


lEITX 


Return  Values 


e 


REAL 


REAL 


Meanin 


time  required  to  fly  the 
specified  ranoe 


rocedure  failed 


Error 


stderr 


Errors 


Reason  for  Error 


Ballistics  -  no  convergence  on  fliaht  time 


Table  2.5-28:  ballistics  calc  time  Information. 
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2. 5. 2. 1.2  ballistics_calc_se 

IThis  routine  computes  and  returns  the  superelevation  required  for  certain  type  of 
aimmunition  to  fly  the  s|^ified  range.  On  call,  the  function  is  passed  pointers  to  arrays 
containing  the  polynomial  coefficients  for  the  functions  xb  =  f(t),  yb  =  f(t),  and  the  vdue  of 
dhe  range  desirkl.  The  superelevation  angle  is  returned  in  radians. 

Parameters  are  represented  as  follows: 
xcbjco^cients  -  polynomial  coefficient 

yibj:oefficients  --  polynomial  coefficient 

itlesiredjrange  -  desired  range 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

*‘xb_coefficients 

pointer  to  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

•'yb_coefficients 

pointer  to  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

mmge 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

siuperelevation 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

tof 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

x*b 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

yib 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

Siuperelevation 

REAL 

the  superelevation  angle 
required  to  fly  the  specified 
range 

1  Calls  1 

Function 

Where  Described 

ballistics  caic  time 

Section  2. 5. 2.1.1 

Table  2.5-29:  ballisUcs_caic_se  Information. 
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2.S.2.2  ball  fire.c 

(./simnetAi3ease/src/vehicle/libsrc/libbail/ball_fire.c) 

Includes: 

"stdio.h" 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 

"libmatrix.h" 

"Ubmsg.h" 

"libevent.h" 


2 . 5 . 2 . 2 . 1  ballistics_fi  re_a_round 

This  routine  sends  ballistics  data  to  the  CIG  system  when  firing  a  round. 

Parameters  are  represented  as  follows: 
ammo  —  the  ammunition  type 


gun position 
gunvelocity 
gunjoworld 
tracer  lit 
rowuT  id 


the  gun's  location  in  world  coordinates 
the  gun's  volocity  in  world  coordinates 
the  transfer  matrix  for  gun  to  world  coordinates 
the  flag  indicating  if  any  tracers 

the  event  flag  for  the  round  (sent  to  the  CIG,  then  received  back 
upon  impact) 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

ammo 

int 

standard 

gun_position 

VECTOR 

/simnet/common/include/glob 
al/sim  tvpes.h 

gun_velocity 

VECTOR 

/simnet/common/include/glob 
al/sim  tvpes.h 

gun_to_world 

T_MATRIX 

/simnet/common/include/glob 
al/sim  types. h 

tracer  lit 

int 

standard 

round  id 

int 

standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

xy_proj 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

a2_sin 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

az_cos 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

1  Calls 

Function 

Where  Described 

store  round  fired 

Section  2.1.2.2.2.14.4 

Table  2.5-30:  ballistics_fire_a_round  Information. 
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2. 5. 2. 3  ball  load.c 

(./simnet/reiease/src/vehicle/Iibsrc/libbal]/ball_load.c) 

Includes: 

"stdio.h" 

"math.h" 

"sim_(ifns.h" 

"sini_types.h" 

"sim_macros.h" 

"basic.h" 

"Ubmap.h" 

"libmsg.h" 


Defines: 

MAX_BALLISTIC_TABLE_SIZE 
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2. 5. 2. 3.1 


ballistics_load_trajectory_file 


This  routine  is  passed  a  ballistics  data  (.d)  file  containing  the  trajectory  points.  It 
downloads  these  points  to  the  CIG. 


Parameters  are  represented  as  follows: 

file  "  the  name  of  the  ballistics  data  file  to  be  downloaded  to  the  CIG 

ammojype  -  the  ammunition  type 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

•file 

pointer  to  char 

standard 

ammojype 

ObjectType 

/simnet/common/include/prot 
ocol/p  sim.h 

ammo  index 

int 

standard 

1  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

‘fp 

pointer  to  FILE 

num  entries 

int 

standard 

i 

int 

standard 

time[MAX  BALLISTIC 

TABLE  SI2E1 

REAL 

/simnet/common/include/glob 
al/sim  types. h 

yb[MAX  BALLISTIC 

TABLE  SIZE! 

REAL 

/simnet/common/include/glob 
al/sim_  types.h 

zbIMAX  BALLISTIC 

TABLE  SI2E1 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

ammo 

int 

standard 

1  Errors  1 

1  Error 

Reason  for  Error 

1  stderr 

Cannot  open  file 

1  Calls  1 

Function 

Where  Described 

mao  oet  ammo  entry  from  network  type 

Section  2.6.11.2.1 

cio  msq  append  trai  table  xfer 

Section  2.1.2.2.2.11.1 

Table  2.5-31:  balIistics_load_trajectory_file  Information. 
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2. 5. 2. 3. 3  ballisticsJoad_parameter_file 


This  routine  downloads  a  parameter  file  (.p)  into  the  simulation.  The  file  contains  two 
polynomials:  1)  the  range  vs.  time,  and  2)  the  drop  vs.  time.  These  polynomial  are  used  to 
generate  the  ballistics  curve  passed  to  the  CIG. 


Parameters  are  represented  as  follows: 

file  --  the  name  of  the  parameter  file  to  be  downloaded 

yb_coeffl]  -  the  distance  y  component  (distance  out) 

zb_co^]  —  the  distance  z  component  (distance  drop) 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

•file 

pointer  to  char 

standard 

yb_coeff[] 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

zb_coeffU 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

1  Internal  Variables  1 

[Variable 

Type 

Where  Typedef  Declared 

l*tP  _ 

pointer  to  FILE 

1  Errors  1 

Error 

Reason  for  Error 

stderr 

Cannot  open  file 

Table  2.5-32:  ballistics_load_parameter_file  Information. 
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2. 5. 2. 4  ball  orient.c 

(./simnetASease/srcMhicle/libsrc/libball/ball_orient.c) 

Includes: 

"stdio.h" 

"ctype.h" 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 

"Ubmatrix.h" 

Variable  Declarations: 
o_mat 

2 . 5 . 2 . 4 . 1  ballistics_cal_azm_elev 

This  routine  calculates  the  azimuth  and  elevation  from  the  direction  cosine  matrix. 

This  routine  is  given  a  gun  to  world  matrix,  m.  The  routine  passes  a  pointer  to  the  matrix 

which  contains; 

[1.1]  -- the  sine  of  the  elevation  angle 

[  1 ,2]  -  the  cosine  of  the  elevation  angle 

[2.1]  -  the  sine  of  the  azimuth 

[2.2]  "  the  cosine  of  the  azimuth 

[3.1]  --  zero 

[3.2]  -  zero 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

m 

T_MATRIX 

/simnet/common/include/glob 
al/sim  types.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

elevation_sin 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

elevation_cos 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

Table  2.5-33:  ballistics  calc  azm  elev  Information. 
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2.5.3  libmissile 

(ysimnet/telease/src/vehicle/libsic/libmissilelibmissile]) 

This  CSU  provides  functions  for  the  launching,  flying,  and  detonation  of  various  types  of 
missiles. 


2.5.3. 1  fuze  prox.c 

(ysimnetAi^ease/src/vehicle/libsrc/libmissile^ze_prox.c) 

This  file  contains  the  code  which  is  called  by  specific  missiles  with  proximity  fuses  to 
determine  if  the  missile  should  be  detonated  due  to  its  close  proximity  to  a  vehicle. 

Includes: 

"stdio.h" 

"sim_types.h" 

"sim_dfns.h" 

"sim_macros.h" 

"basic.h" 

"/simnet/commonfinclude/protocol/p_sim.h" 

"Ubnear.h" 

"libmatrix.h" 

"libmiss_dfn.h" 

"libmiss_loc.h" 


Defines: 

NUM.PROX 

Declarations: 

proxjist  [NUM_PROX] 
prox.free  [NUM_PROX] 
free_ptr 
mallocO 

The  following  routines  arc  declared  static  to  this  module: 
get_prox() 

free _ prox() 

dfd_vec_sub() 

f2d_vec”scale() 

f2d_martranspose() 

2.5.3. 1.1  missile_fuze_prox_init 

This  routine  sets  up  the  statically  allocated  memory.  Each  element  of  prox  jist  is  statically 
allocated  and  a  pointer  is  assigned  to  each  element  in  prox  Jree.  free _ptr  is  set  to  point  to 
the  first  element  in  prox  Jree. 


1  Internal  Variables  I 

Internal  Variable 

Where  Typedef  Declared 

i 

int 

Standard 

Table  2.5-34;  missile  fuze  prox  init  Information. 
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2.5.3. 1.2  inissile_fuze_prox 

This  routine  deteimines  which  vehicles  are  close  enough  to  the  missile  to  be  considered 
potential  targets  of  the  missile.  A  linked  list  of  three  potential  targets  is  maintained.  Given 
the  cuirent  position  and  velocity  of  both  a  missile  and  a  target,  this  routine  determines  if 
their  proximity  is  close  enough  to  detonate  the  missile.  If  &ey  are  close  enough  to  cause  a 
detCMiation,  but  a  closer  approach  is  predicted,  detonation  is  guaranteed  but  delayed  to  allow 
for  the  closer  detonation.  This  routine  deals  with  a  single  time  step.  During  this  time  step, 
both  the  missile  and  target  fly  along  paths  which  can  be  described  as  chords  in  space.  The 
chords  are  defined  by  initial  points  and  direction  vectors  whose  lengths  are  equal  to  the 
lengths  of  the  chords.  These  chords  are  velocity  vectors  measured  in  units  of  distance  per 
tic£  Both  the  target  and  missile  are  assumed  to  travel  the  lengths  of  their  resp^tive  chords 
at  a  constant  rate.  The  distance  traveled  is  described  by  a  parameter  which  varies  from  -1.0 
to  0.0.  The  parameter  for  both  chords  is  always  the  same. 


The  parameters 
mptr 

target_flag 


targ_vehicle_id 

first_targ 

vehjist 

invest_dist_2 

prox_dist_2 


are  defined  as  follows; 

-  a  pointer  to  the  missile  whose  fuse  is  being  processed. 

-  a  flag  that  indicates  which  set  of  vehicles  are  to  be  tested  for  fuse 

detonation.  If  it  is  set  to  PROX_FLJZE_ON_NO_VEH  ,  the 
fuse  is  not  armed.  The  fuse  will  only  detonate  when  it  is 
near  the  specified  vehicle  if  it  is  set  to 
PROX_FUZE_ON_ONE_VEH.  A  value  of 
PROX_FUZE_ON_ALL_VEH  wiU  allow  the  fuse  to 
detonate  when  it  is  close  enough  to  any  vehicle  in  the  vehicle 
list. 

-  a  pointer  to  the  vehicle  ID  of  the  vehicle  which  will  cause  the 

missile  to  detonate  if  it  is  close  enough. 

-  a  pointer  to  the  first  PROX  element  on  the  list  of  the  missile. 

Various  targets  are  maintained  by  using  a  linked  list. 

-  the  list  to  check  for  possible  targets. 

-  the  square  of  the  distance  within  which  the  target  must  be  for  the 

missile  to  maintain  it  as  a  possible  detonation. 

-  the  square  of  the  distance  between  the  missile  and  the  target  which 

will  cause  the  missile  to  detonate. 


The  internal  variables 

target 

vehcount 

currenttarg 

missile_vel 

missile j)os 

not Joundexpl 


temptarg 

veljiiff 

termdiff 

veljdotvel 

termdotjerm 

termdotvel 

closestapproach 


are  defined  as  follows; 

-  a  pointer  to  an  appearance  packet  of  a  target. 

-  an  index  to  the  vehicles  list. 

-  a  pointer  to  a  PROX  element. 

-  the  velocity  vector  of  the  missile. 

-  a  pointer  to  the  missile  location  vector. 

-  a  flag  which  indicates  that  a  target  which  cannot  be  found  during 

this  tick  would  have  caused  a  detonation  during  the  last  tick, 
but  a  closer  approach  was  predicted. 

-  a  temporary  pointer  to  a  PROX  element. 

-  a  vector  difference  between  the  missile  and  target  velocities. 

-  the  vector  difference  between  the  initial  points  of  the  missile  and 

target  pathway  chords. 

-  the  dot  product  of  vel  diffv/ith  itself. 

-  the  dot  product  of  term  diff  wilh  itself. 

-  the  dot  product  of  term_diffv/ith  veljiiff. 

-  the  value  of  the  chord  position  parameter  where  the  closest 

approach  occurs. 


959 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


ndn  allowedjjpproach  -  the  value  of  the  chord  position  parameter  where  the  closest 

approach  occurs  between  -1.0  and  0.0. 
min  j}rox_dist_2  -  the  square  of  the  closest  approach  distance. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

motr 

pointer  to  MISSILE 

Section  2.5.3.2 

taraet  flaa 

int 

Standard 

targ_vehicle_id 

pointer  to  VehiclelD 

/simnet/common/include/prot 

ocol/basic.h 

first  taro 

pointer  to  a  pointer  to  PROX 

Section  2.5.3.2 

veh  list 

int 

Standard 

invest_dist_2 

REAL 

/simnet/common/include/prot 
ocol/sim  types,  h 

prox_dist_2 

REAL 

/simnet/common/include/prot 
ocol/sim  types,  h 

1  Internal  Variables  I 

Internal  Variable 

Where  Typedef  Declared 

target 

pointer  to 

VehicleAppearanceVariant 

/simnet/common/include/prot 

ocol/p_sim.h 

veh  count 

int 

Standard 

current  tarq 

pointer  to  register  PROX 

Section  2.5.3.2 

i 

register  int 

Standard 

missile_vel 

VECTOR 

/simnet/common/include/prot 
ocol/sim  types.h 

missile jjos 

pointer  to  a  REAL 

/simnet/common/include/prot 
ocol/sim  types.h 

not  found  expl 

int 

Standard 

temp  targ 

pointer  to  PROX 

Section  2.5.3.2 

veLdiff 

VECTOR 

/simnet/common/include/prot 
ocol/sim  types.h 

term_diff 

VECTOR 

/simnet/common/include/prot 
ocol/sim  types.h 

veLdot_vel 

REAL 

/simnet/common/include/prot 
ocol/sim  types.h 

term_dot_term 

REAL 

/s  i  mnet/co  mmo  n/include/prot 
ocol/sim  types.h 

REAL 

/simnet/common/include/prot 
ocol/sim  types.h 

closest_approach 

REAL 

/simnet/common/include/prot 
ocol/sim  types.h 

min_allowed_approach 

REAL 

/simnet/common/include/prot 
ocol/sim  types.h 

min_prox_dist_2 

REAL 

/simnet/common/include/prot 
ocol/sim  types.h 

1  Calls  1 

Function 

Where  Described 

vec  scale 

Section  2.6.2.64 

near_get_next  _veh_near_ 
point 

Section  2.5.17.1.1 

get  prox 

Section  2. 5. 3. 1.4 
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VEHICLE  IDS  EQUAL 

/simnet/common/include/Qlobal/sim  macros. h 

near_jget_veh_if_stilLnear_ 

DOint 

Section  2.5.17.1.2 

free  orox 

Section  2.5.3.1.5 

dfd  vec  sub 

Section  2.5.3.1.7 

vec  sub 

Section  2.6.2.65 

vec  dot  orod 

Section  2.6.2.54 

vec  scale 

Section  2.6.2.64 

vec  add 

Section  2.6.2.57 

f2d  vec  scale 

Section  2.5.3.1.8 

f2d  mat  transpose 

Section  2.5.3.1.6 

missile_utiLcommJu2e_ 

detonate 

Section  2.5.3.25.6 

Table2.5-35:  inissile_fuze_prox  Information. 


2. 5. 3. 1.3  missile_fuze_prox_stop 

This  routine  frees  up  PROX  memory  associated  with  a  particular  missile,  first  targ  is  a 
pointer  to  a  pointer  to  a  PROX  list,  targ  is  a  pointer  to  a  PROX  list. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

first,  tara 

pointer  to  pointer  to  PROX 

Section  2.5.3. 2 

1  Internal  Variables  I 

Internal  Variable 

Where  Tvpedef  Declared 

tarq 

pointer  to  PROX 

Section  2.5.3.2 

1  Calls  1 

Function 

Where  Described 

free  prox 

Section  2.5.3. 1.5 

Table  2.5-36:  missile_fuze_prox_stop  Information. 


961 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


2.5.3. 1.4  get_prox 


This  routine  finds  a  free  entry  in  prox  jist  if  one  exists.  Pointers  to  free  elements  in 
proxjist  are  kept  in  prox  Jree.  If  none  of  the  elements  in  proxjist  are  free,  a  PROX 
element  is  allocated  from  memory  and  a  pointer  is  returned  to  it  The  routine  records  if 
memory  has  been  allocated.  prox_alloc  is  a  pointer  to  a  PROX  element  allocated  from 
memory. 


1  Internal  Variables  | 

Internal  Variable 

Type 

Where  Typedef  Declared 

prox  alloc 

pointer  to  PROX 

Section  2.5.3.2 

1  Return  Values  I 

1  Return  Value 

Type 

Meaning 

static 

a  free  entry  in  proxjist 

prox_alloc 

static 

pointer  to  a  PROX  element 
allocated  from  merrxjrv 

Table  2.5-37:  get_prox  Information. 


2.5.3. 1.5  free_prox 


This  routine  frees  the  memory  of  a  PROX  element  if  it  is  no  longer  needed.  If  it  is  an 
element  of  proxjist,  a  pointer  to  it  is  put  into  prox  Jree;  otherwise,  the  memory  is  restored 
to  the  stack,  prox _ptr  is  a  pointer  to  an  element  to  be  freed. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

prox  ptr 

pointer  to  PROX 

Section  2.5. 3.2 

Table  2.5-38:  free_prox  Information. 


2.5.3. 1.6  f2d_mat_transpose 

This  routine  puts  the  transpose  of  the  (float)  matrix  src  into  the  (REAL)  matrix  dst. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

src 

3  by  3  matrix  of  float 

Standard 

dst 

3  by  3  matrix  of  REAL 

/simnet/common/include/prot 
ocol/sim  tvpes.h 

Table  2.5-39:  f2d_mat_transpose  Information. 
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2. 5. 3. 1.7  dfd_vec_sub 

This  routine  finds  result  =  v7-v2. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

v1 

VECTOR 

/simnet/common/include/prot 
ocol/sim  types. h 

v2 

array  3  of  float 

Standard 

result 

VECTOR 

/simnet/common/include/prot 
ocol/sim  types.h 

Table  2.5-40:  dfd  vec  sub  Information. 


2. 5. 3. 1.8  f2d_vec_scale 

This  routine  scales  the  float  vector  v  by  scale  Jdctor  and  puts  the  result  in  the  (REAL) 
vector  result. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

v 

array  3  of  float 

Standard 

scalejactor 

REAL 

/simnet/common/include/prot 
ocol/sim  Jypes.h 

result 

VECTOR 

/simnet/common/include/prot 
ocol/sim  types.h 

Table  2.5-41:  f2d  vec  scale  Information. 


2. 5. 3. 2  libmiss_dfn.h 

(./simnet/rclease/src/vehicle/libsrc/libmissile/libmiss_dfn.h) 

This  file  contains  type  definitions  used  only  with  the  missile  library. 


2. 5. 3. 3  libmiss_loc.h 

(./simnetAelease/src/vehicle/libsrc/libmissile/libmiss_loc.h) 

This  file  contains  function  declarations  used  only  within  the  missile  library. 


2. 5. 3. 4  libmissile.h 

(./simnet/release/src/vehicle/libsrc/libmissileAibmissile.h) 

This  file  contains  function  definitions  used  both  inside  and  outside  the  missile  library. 
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2. 5. 3. 5  miss  adat.c 

(./simnet/reTease/src/vehicle/libsrc/libmissile/miss_adat.c) 

This  file  contains  routines  which  fly  out  a  missile  with  the  characteristics  of  an  ADAT 

missile. 

Includes; 

"stdio.h" 

"math.h" 

"sim_types.h" 

"sim_^ns.h" 

basic.h" 

"mun_type.h" 

"libmap.h" 

"libmatrix.h" 

miss_adat.h" 

"libmiss_dfn.h" 

"libmiss_loc.h" 

The  following  define  the  missile  characteristics: 

ADAT_BURNOUT_TIME 

ADAT_MAX_FUGHT_TIME 

B^ST_DIST_SQ 

HELO_FUZE_DIST  SQ 

AIR_FUZE_DIST_SQ 

ADAT_TEMP_BIA.S_TIME 

CLOSE_R4NGE 

The  following  define  the  possible  states  of  the  ADAT_MISS1LE: 

ADAT_FREE 

ADAT_GUIDE 

ADAT_UNGUIDE 

ADAT_C1jOSE 

ADAT_NOT 

The  following  terms  set  the  order  of  the  polynomials  used  to  determine  the  speed  or  the 

cosine  of  the  maximum  allowed  turn  rate  of  the  missile  at  any  point  in  time: 
ADAT_BURN_SPEED_DEG 
ADAT_COAST_SPEED_DEG 
ADAT_BURN_TURN_DEG 
ADAT_COAST_TURN_DEG 
ADAT_TEMP_BIAS_DEG 

Coefficients  for  the  speed  polynomial  before  motor  burnout: 

adat  _bum_speed_coeff  (ADAT_BURN_SPEED_DEG  +  1  ] 

Coefficients  for  tlie  speed  [X)lynomiaI  after  motor  burnout: 

adat_coast  speed  cocfflADAT_COAST  SPEED  DEG  +  1) 

Coefficients  for  the  cosine  of  maximum  turn  polynomial  before  motor  burnou;: 
adat^bum  turn  coeff  (ADAT.BURN  TURN  DEG  +  11 
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Coefficients  for  the  cosine  of  maximum  turn  polynomial  after  motor  burnout: 
adat_coast_tum_coeff  [ADAT_COAST_SPEED_DEG  + 1] 

Coefficients  for  the  temporal  bias  polynomial: 

acIat_temp_bias_coeff  [ADAT_TEMP_BIAS_DEG  +  1] 

The  following  arrays  arc  used  to  give  the  missile  the  proper  superelevation  at  launch  time. 
Two  are  required  to  deal  with  launches  off  either  side  of  the  turret. 
tube_C_sight_left 
tube_C_sight_right 

Memory  for  the  missiles  is  declared  in  vehicle  specific  code.  During  initialization,  a  pointer 
is  assigned  to  this  memory,  then  some  memory  issues  are  handled  in  this  module. 
adat  array  is  a  pointer  to  missile  memory,  and  num  adats  is  the  number  of  defined 
missiles. 

The  following  functions  arc  declared  as  static: 
niissile_adat_fly() 
inissile_adat_stop() 


2. 5. 3. 2.1  missile_adat_init 

This  routine  copies  the  parameters  into  variables  static  to  this  module  and  initializes  the  state 
of  all  the  missiles.  It  also  initializes  the  proximity  fuse,  missilejirrayf y  is  a  pointer  to  an 
array  of  ADAT  missiles  in  vehicle  specffic  code,  numjnissiles  is  the  number  of  missiles 
defined  in  missile _array.  mag  is  us^  to  generate  tube  to  sight  matrices. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

missile  array 

array  of  ADAT  MISSILE 

Section  2.5. 3. 6 

num  missiles 

int 

Standard 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard 

mag 

REAL 

/simnet/common/include/prot 
ocol/sim  types. h 

Calls 

Function 

Where  Described 

missile  fuze  prox  init 

Section  2.5.3.1.1 

mat  copy 

Section  2.6.2.39.1 

Table  2.5*42:  missile  adat  init  Information. 


2. 5. 3. 2. 2  missile_adat_fire 

This  routine  performs  the  functions  specifically  related  to  the  firing  of  an  ADAT  missile. 
The  parameters  arc  defined  as  follows: 

aptr  -  a  pointer  to  the  ADAT  missile  to  be  fired. 
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targetjype 

launch _point 

loc  sight  Jo _world 
launchspeed 

range  to  intercept 
tube 

target jehicleid 
The  relevant  internal 
mptr 

commtargettype 


-  the  type  of  target  for  which  the  missile  can  be  set  by  the  launching 

vehicle. 

-  the  location,  in  world  coordinates,  from  which  the  missile  is 

launched. 

-  the  sight  to  world  transformation  matrix  used  only  in  this  routine. 

-  the  spi^  of  the  launch  platform  (assumed  to  be  in  the  direction  of 

the  missile). 

-  the  range  to  intercept. 

-  the  tube  from  which  the  missile  was  launched. 

-  the  vehicle  ID  of  the  target  (if  any), 
variables  are  as  follows: 

-  the  pointer  to  the  particular  generic  missile  to  which  aptr  points. 

-  an  indication  of  whether  or  not  the  target  is  known. 


Parameter 


EEimxn; 


launchjaoint 


loc_sight_to_world 


launch_speed 


range_toJntercept 


tube 


target_vehiclejd 


Parameters 


e 


inter  to  ADAT  MISSILE 


int 


VECTOR 


T  MATRIX 


pointer  to  VehiclelD 


Where  Typedef  Declared 


Section  2.5. 3.6 


Standard 


/simnet/common/include/prot 
ocol/sim  types. h 


/simnet/common/include/prot 
ocol/sim  tvpes.h 


/simnet/common/include/prot 
ocol/sim  tvpes.h 


/simnet/common/include/prot 
ocol/sim  types. h 


Standard 


/simnet/common/include/prot 

ocol/basic.h 


Internal  Variables 


Internal  Variable 


comm  taroet  type 


Return  Value 


TRUE 


FALSE 


Function 


vec  CO 


mat  CO 


mat  mat  mul 


Where  Typedef  Declared 


Standard 


Section  2. 5. 3.2 


Standard 


Return  Values 


Type 


int 


int 


Meaning 


successful 


not  successful 


Calls 


Where  Described 


Section  2.6.2.59 


Section  2.6.2.39.1 


Section  2.6.2.32.1 
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2. 5. 3. 2. 3  inissne_adat_ny_missiles 

This  routine  flies  out  all  missiles  in  a  flying  state,  sight  location  is  the  location  in  world 
coordinates  of  the  gunner's  sight  loc  sight  to  world  is  the  sight  to  world  transformation 
matrix  used  only  in  this  routine,  veh  jist  is  the  vehicle  list  ID. 


Parameters 

Parameter 

Where  Typedef  Declared 

sightjocation 

VECTOR 

/simnet/common/include/prot 
ocol/sim  tvoes.h 

loc_sight_to_world 

T_MATRIX 

/simnet/common/include/prot 
ocol/sim  tvpes.h 

veh  list 

int 

Standard 

Internal  Variables 


Internal  Variable 


lEin 


Where  TvDedef  Declared 


Standard 


Function 


missile  adat  fl 


Calls 


Where  Described 


Section  2.5.3.2.4 


Table  2.5-44:  missile_adat_fly_missiles  Information. 
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2. 5. 3. 2. 4  inissile_adat_fly 

This  routine  performs  the  functions  specifically  related  to  the  flying  of  an  AD  AT  missile. 


The  parameters  are  represented  as  follows: 

aptr  -  a  pointer  to  the  ADAT  missile  that  is  to  be  flown  out 

sightjocadon  -  the  location  in  world  coordinates  of  the  gunner's  sight. 

loc_sight_to_world  -  the  sight  to  world  transformation  matrix  used  only  in  this  routine. 
tube  -  the  tube  from  which  the  missile  was  launched. 

veh  jist  -  the  vehicle  list  ID. 


Internal  variables  are  as  follows: 

mptr  -  a  pointer  to  the  generic  aspects  of  aptr. 

time  -  the  current  time  after  launch  in  ticks. 

bias  -  the  value  of  the  temporal  bias. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

aptr 

ADAT  MISSILE 

Section  2.5.3.6 

sight  Jocation 

VECTOR 

/simnet/common/include/prot 
ocol/sim  types. h 

loc_sight_to_world 

T_MATRIX 

/simnet/common/include/prot 
ocol/sim  types. h 

tube 

int 

Standard 

veh  list 

int 

Standard 

Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

mptr 

MISSILE 

Section  2.5.3.2 

time 

REAL 

/simnet/common/include/prot 
ocol/sim  types. h 

bias 

REAL 

/simnet/common/include/prot 
ocol/sim  types.h 

1  Calls  1 

Function 

Where  Described 

missile  util  eval  poly 

Section  2.5.3.26.1 

missile  target  los  bias 

Section  2.5.3.29.1 

missile  target  los 

Section  2.5.3.19.1 

missile  target  unguided 

Section  2.5.3.24.1 

missile  util  flyout 

Section  2.5.3.27.1 

missile  adat  stop 

Section  2.5.3.2.5 

missile  fuze  prox 

Section  2.5.3. 1.2 

missile_util_comm_check_ 

detonate 

Section  2.5.3.25.9 

Table  2.5-45;  missile_adat_fly  Information. 
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2.5.3. 2.4 


missile  adat  reset  missiles 


This  routine  puts  any  flying  missile  into  an  unguided  state. 


1  Internal  Variables  I 

Internal  Variable 

Type 

Wherr  Typedef  Declared 

i 

int 

Standard 

Table  2.5-46:  missile  adat  reset  missiles  Information. 


2. 5. 3. 2. 5  missiie_adat_stop 

This  routine  causes  all  concerned  to  forget  about  the  missile,  releasing  the  memory  for  use 
by  other  missiles.  It  should  be  called  when  the  flyout  of  any  ADAT  missile  is  stopped 
(whether  or  not  it  has  exploded).  Note  that  this  routine  can  only  be  called  within  this 
module,  aptr  is  a  pointer  to  a  missile  that  is  to  be  stopped. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

aotr 

pointer  to  ADAT  MISSILE 

Section  2. 5. 3.6 

1  Calls  1 

Function 

Where  Described 

missile  fuze  prox  stop 

Section  2.5.3.1.3 

missile_util_comm_stop_ 

missile 

Section  2.5.3.25.7 

Table  2.5-47:  missile_adat_stop  Information. 


2. 5. 3. 6  miss_adat.h 

(./simnetAelease/src/vehicle/libsrc/libmissile/miss_adat.h) 

This  file  contains  structure  and  function  declarations  that  relate  specifically  to  the  ADAT 
missile  and  are  used  outside  the  missile  library. 
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2. 5. 3. 7  miss  hellfr.c 

(./simnet/telease/src/vehicle/libsrc/libmissile/miss_hellfr.c) 

This  file  contains  routines  which  fly  out  a  missile  with  the  characteristics  of  a  HELLFIRE 

missile. 

Includes: 

"stdio.h" 

"math.h" 

"sim_types.h" 

"sim_dfns.h" 

"basic. h" 

"mun_type.h" 

"Ubmap.h" 

"miss_hellfr.h" 

"Iibmiss_dfn.h" 

"libmiss_loc.h" 

The  following  define  the  missile  characteristics: 

HELLFIRE_ARM_T[ME 

HELLnRE_BURNOUT_TIME 

HELLFIRE_MAX_FLIGHT_TIME 

SPEED  0 

THETA.O 

The  following  parameters  control  flight  trajectory  brehavior: 

SIN.UNGUIDE 

COS.UNGUIDE 

SIM_CLIMB 

CXDS.CLIMB 

SIM.LOCK 

CX)S_LOCK 

COS.TERM 

COS.LOSE 

The  following  terms  set  the  order  of  the  polynomials  used  to  determine  the  speed  or  the 

cosine  of  the  maximum  allowed  turn  rate  of  the  missile  at  any  point  in  time. 
HELLnRE_BURN_SPEED_DEG 
HELLFIRE_COAST_SPEED_DEG 

Coefficients  for  the  speed  polynomial  before  motor  burnout: 

hellfire_bum_speed_coeff  [HELLFIRE_BURN_SPEED_DEG  +  1] 

Coefficients  for  the  speed  polynomial  after  motor  burnout: 

hellfire_coast_spe^_coeff  [HELLFIRE_COAST_SPEED_DEG  +  1] 


Static  function  declarations- 

missilehellfirestopO 


BBN  Systems  and  Technologies 


Vehicles  CSCl 


2. 5. 3. 7.1  missile  hellfire  init 


This  routine  initializes  the  state  of  the  missile  to  indicate  that  it  is  available,  and  sets  values 
that  never  change,  n^tr  is  a  pointer  to  the  HELLFIRE  missile  to  be  initialized. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

motr 

DOinter  to  MISSILE 

Section  2.5.3.2 

Table  2.5-48:  missile_hellfire_init  Information. 


2. 5. 3. 7. 2  missile  hellfire  fire 


This  routine  performs  the  functions  specifically  related  to  the  firing  of  a  HELLFIRE 
missile.  The  parameters  are  represented  as  follows: 


mptr 

launch joint 

launch  Jo _world 
launchspeed 

tube 


-  a  pointer  the  the  HELLFIRE  missile  that  is  to  be  launched. 

-  the  location,  in  world  coordinates,  from  which  the  missile  is 

launched. 

-  the  transformation  matrix  of  the  launch  platform  to  the  world. 

-  the  speed  of  the  launch  platform  (assumed  to  be  in  the  direction  of 

the  missile). 

-  the  tube  from  which  the  missile  was  launched. 


j  Parameters  | 

Parameter 

Where  Typedef  Declared 

mptr 

pointer  to  MISSILE 

Section  2.5.3.2 

launchjaoint 

VECTOR 

/simnet/common/include/prot 
ocol/sim  types. h 

launchjo_world 

T_MATRIX 

/simnet/common/include/prot 
ocol/sim  types. h 

launch_speed 

REAL 

/simnet/common/include/prot 
ocol/sim  types. h 

tube 

int 

Standard 

Calls 

Function 

Where  Described 

vec  CODY 

Section  2.6.2.59 

mat  CODY 

Section  2.6.2.39.1 

Section  2.5.3.26.1 

missile_utiLcomm_fire_ 

missile 

Section  2.5.3.25.2 

map_get_ammo_entry_from_ 
network  tYPe 

Section  2.6.11.2.1 

Table  2.5-49:  missile  hellfire  fire  Information. 
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2. 5. 3. 7. 3  inissile_h'e:llfire_fly 

This  routine  performs  the  fiunctions  specifically  related  to  the  flying  of  a  HELLPIRE 
missile,  r^tr  is  a  pointerto  the  HELLFIRE  missile  to  be  flown  out.  target Jocation  is  the 
location,  in  world  cocnxhnaites,  of  the  target,  time  is  the  current  time  after  launch  in  ticks. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

mptr 

pointer  to  MISSILE 

Section  2.5.3.2 

target.location 

VECTOR 

/simnet/common/include/prot 
ocol/sim  types,  h 

internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

time 

register  REAL 

/simnet/common/include/prot 
ocol/sim  types. h 

1  Calls  1 

Function 

Where  Described 

missile  util  eval  poly 

Section  2.5.3.26.1 

missile  taraet  aam 

Section  2.5.3.15.1 

missile  util  flyout 

Section  2.5.3.27.1 

missile  hellfire  stop 

Section  2.5.3.7.4 

missile_util_comm_check_ 

intersection 

Section  2.5.3.25.8 

missile_util_comm_check_ 

detonate 

Section  2.5.3.25.9 

Table  2,5-50:  inissile_hellfire_fly  Information. 


2. 5. 3. 7. 4  missire_ll«ellfire_stop 

This  routine  causes  all  conoemed  to  forget  about  the  missile,  releasing  the  memory  for  use 
by  other  missiles.  It  should!  be  called  when  the  flyout  of  any  HELLFIRE  missile  is  stopped 
(whether  or  not  it  has  exploiied.)  Note  that  this  routine  can  only  be  called  within  this 
module,  mptr  is  a  pointer  tihe  the  HELLFIRE  missile  that  is  to  be  stopped. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

mptr 

pointer  to  MISSILE 

Section  2.5. 3.2 

Calls 

Function 

Where  Described 

missile_util_comm_stop_ 

missile 

Section  2.5.3.25.7 

Table  2.5-51:  missile  hellfire  stop  Information. 
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2. 5. 3. 8  miss  hellfr.h 

(./simnetAeTease/src/vehicle/libsrc/libmissile/miss_hellfr.h) 

This  file  contains  structure  and  function  declarations  that  relate  specifically  to  the 
HELLFIRE  missile  and  are  used  outside  the  missile  library. 


2. 5. 3. 9  miss_maverick.c 

(ysimnet/release/src/vehicle/libsrc/libmissile/miss_maverick.c) 

This  file  contains  routines  which  fly  a  missile  with  the  characteristics  of  a  MAVERICK 
missile. 

Includes: 

"stdio.h" 

"math.h" 

"sim_types.h" 

"sim_dfns.h" 

"basic.h" 

"mun_type.h" 

"libmap.h" 

"libmatrix.h" 

"libnear.h" 

"miss_maverck.h" 

"libmiss_dfn.h" 

"libmissjoc.h" 


Defines: 

The  following  define  the  missile  characteristics: 
MAVERICK_ARM_TIME 
MAVERICK_BURNOUT_TIME 
MAVERICK_MAX_FLIGHT_TIME 
MAVERICK_LOCK_THRESHOLD 
MAVERICK_HOLD_THRESHOLD 
SPEED_0 
THETA.O 


The  following  parameters  control  flight  trajectory  behavior: 
SIN.UNGUIDE 
COS.UNGUIDE 
SIN.CLIMB 
COS_CLIMB 
SIM.LOCK 
COS_LOCK 
COS_TERM 
COS_LOSE 


The  following  define  the  possible  states  of  the  MAVERICK_MISSILE: 
MAVERICK_FREE 
MAVERICK.READY 
MAVERICK_FLYING 
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The  following  terms  set  the  order  of  the  polynomials  used  to  determine  the  speed  or  the 
cosine  of  the  nnaximum  allowed  turn  rate  of  the  missile  at  any  point  in  time. 
MAVIERICK_BURN_SPEED_DEG 
MAVEdUCK_COAST_SPEED_DEG 


Coefficients  fi»r  the  speed  polynomial  before  motor  burnout: 

maveriick_buni_speed_coeff  [MAVERICK_BURN_SPEED_DEG  + 1] 


Coefficients  fcs^  the  speed  polynomial  after  motor  burnout; 

maveriick_coast_speed_coeff  [MAVERICK_COAST_SPEED_DEG  +  1] 

Memory  for  tl^  missiles  is  declared  in  vehicle  specific  code.  During  initialization,  a  pointer 
is  assigned  to  tihis  memory,  then  all  memory  issues  are  handled  in  this  module. 
maverick_arrcm'  is  a  pointer  to  missile  memory,  and  numjnavericks  is  the  number  of 
defined  missiles. 


Static  function  declarations: 

missil(e_maverick_fly() 


2. 5. 3. 9.1  missile_maverick_init 

This  routine  copies  the  parameters  into  variables  that  are  static  to  this  module  and  initializes 
the  state  of  all  ^e  missiles,  missile  array  is  a  pointer  to  an  array  of  MAVERICK  missiles 
defined  in  vehncle  specific  code,  numjnissiles  is  the  number  of  missiles  defined  in 
missile  array.. 


j  Parameters  I 

Parameter 

Where  Typedef  Declared 

missile_array 

pointer  to 

MAVERICK  MISSILE 

Section  2.5.3.10 

num  missiles 

int 

Standard 

Internal  Variables 

Internal  Varls^ble 

Type 

Where  Typedef  Declared 

i 

int 

Standard 

Table  2.5-52:  missile  maverick  init  Information. 
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2. 5. 3. 9. 2  missne_maverick_ready 

This  routine  finds,  if  possible,  a  m'ssile  that  is  not  being  used,  puts  it  in  a  ready  state, 
clears  the  target  ID,  and  returns  a  pointer  to  it. 


tnternai  Variables 


Internal  Variable 


lEiTH 


Where  Tyoedef  Declared 


Standard 


Return  Value 


&maverick_array[i] 


NULL 


Return  Values 


pointer  to 

MAVERICK  MISSILE 


pointer  to 

MAVERICK  MISSILE 


Meaning  _ 


pointer  to  a  missile  that  is 
currently  available 


no  free  missile  was  found 


Table  2.5-53:  inissile_mavenck_ready  Information. 

2 . 5 . 3 . 9 . 3  niissile_ma  verick_pre_launch 

This  routine  is  called  after  a  missile  has  been  readied  and  before  it  has  been  launched.  It 
determines  if  the  seeker  head  can  see  a  targeL  and  if  it  can  see  a  target,  stores  its  position. 
The  parameters  and  internal  variable  are  represented  as  follows: 


mvptr 

launch j)oint 
launchjojvorld 
vehjist 
target 


Parameter 


mvDtr 


launch_point 


launch_to_world 


veh  list 


-  a  pointer  to  the  missile  that  is  to  be  serviced. 

-  the  location  of  the  missile  in  world  coordinates. 

-  the  transformation  matrix  of  the  missile  to  the  world. 

-  the  vehicle  list  ID. 

-  a  pointer  to  the  target  vehicle’s  appearance  packet. 


Parameters 


IE273 


MAVERICK  MISSILE 


VECTOR 


T_MATRIX 


int 


Where  Tyoedef  Declared 


Section  2.5.3.10 


/simnet/common/include/prot 
ocol/sim  types. h 


/simnet/common/include/prot 
ocol/sim  types. h 


Standard 


Internal  Variable 


target 


Internal  Variables 


e 


pointer  to 

Vehicle  AppearanceVariant 


Where  Tyoedef  Declared 


/simnet/common/include/prot 
ocol/p  sim.h 


Calls 

Function 

Where  Described 

near_getj3referred_veh_ 
near  vector 

Section  2.5.17.2.4 

missile  target  pursuit 

Section  2.5.3.23.1 

Table  2.5-54:  missile_maverick_prejaunch  Information. 
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2. 5. 3. 9. 4  missile_inaverick_fire 

This  routine  performs  the  functions  specifically  related  to  the  firing  of  a  MAVERICK 
missile.  The  parameters  and  internal  variables  are  represented  as  follows; 


mvptr 

launch jjoint 

launch  Jo jA/orld 
launchspeed 

tube 


-  a  pointer  to  the  MAVERICK  missile  that  is  to  be  launched. 

-  the  location,  in  world  coordinates,  from  which  the  missile  is 

launched. 

-  the  transformation  matrix  of  the  launch  platform  to  the  world. 

-  the  speed  of  the  launch  platform,  assumed  to  be  in  the 
direction  of  the  missile. 

-  the  tube  from  which  the  missile  was  launched. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

mvptr 

pointer  to 

MAVERICK  MISSILE 

Section  2.5.3.10 

launch_point 

VECTOR 

/simnet/common/include/prot 
ocol/sim  types. h 

launch_to_world 

T_MATRIX 

/simnet/common/include/prot 
ocol/sim  types.h 

launch_speed 

REAL 

/simnet/common/include/prot 
ocol/sim  types.h 

tube 

int 

Standard 

internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

mptr 

pointer  to  MISSILE 

Section  2.5.3.2 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

TRUE 

int 

successful  launch 

FALSE 

int 

unsuccessful  launch 

1  Calls  1 

Function 

Where  Described 

vec  copy 

Section  2.6.2.59 

mat  copy 

Section  2.6.2.39.1 

missile  util  eval  poly 

Section  2.5.3.26.1 

missile_util_comm_fire_ 

missile 

Section  2.5.3.25.2 

mapjet_ammo_entryJrom_ 
network  type 

Section  2.6.11.2.1 

Table  2.5-55:  missile  maverick  fire  Information. 
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2. 5. 3. 9. 5  inissile_inaverick_ny_inissiles 

This  routine  flies  all  missiles  in  a  ready  state,  veh  list  is  the  vehicle  list  ID. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

veh  list 

int 

Standard 

internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard 

Calls 

Function 

Where  Described 

missile  maverick  fly 

Section  2.5.3.9.6 

Table  2.5-56:  missile_maverick_fly_missiles  Informalion. 


977 


BBN  Systems  and  Technologies 


Vehicles  CSQ 


2. 5. 3. 9. 6  inissile_maverick_fly 

This  routine  performs  the  functions  specifically  related  to  the  flying  of  a  MAVERICK 
missile.  The  parameters  are  as  follows: 

mvptr  -  a  pointCT  to  the  MAVERICK  missile  that  is  to  be  flown  out. 

vehjist  -  the  vehicle  list  ID. 

The  internal  variables  are  as  follows: 

mptr  -  a  pointer  to  the  generic  aspects  of  mvptr. 

time  -  the  current  time  after  the  launch,  in  ticks. 

target  -  a  pointer  to  the  target  appearance  packet. 

targetjocation  -  the  location  of  the  target 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

mvptr 

pointer  to 

MAVERICK  MISSILE 

Section  2.5.3.10 

veh  list 

int 

Standard 

Internal  Variables 

Internal  Variable 

Where  Tvpedef  Declared 

motr 

pointer  to  reoister  MISSILE 

Section  2.5.3.2 

time 

REAL 

/simnet/common/include/prot 
ocol/sim  types. h 

target 

pointer  to 

VehicleAppearanceVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

target_location 

VECTOR 

/simnet/common/include/prot 
ocol/sim  types. h 

1  Calls  1 

Function 

Where  Described 

missile  util  eval  poly 

Section  2.5.3.26.1 

missile  taraet  aam 

Section  2.5.3.15.1 

nearjgetj3referred_veh_ 
near  vector 

Section  2.5.17.2.4 

vec  copy 

Section  2.6.2.59 

missile  util  flyout 

Section  2.5.3.27.1 

missile  maverick  stop 

Section  2.5.3.9.7 

missile_utiLcomm_check_ 

intersection 

Section  2.5.3.25.8 

Section  2.5.3.25.9 

Table  2.5*57:  missile_maverick_ny  Information. 
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2. 5. 3. 9. 7  niissiie_mavenck_stop 

This  routine  causes  all  concerned  to  forget  about  the  missile,  releasing  the  missile  memory 
for  use  by  other  missiles.  It  should  be  called  when  the  flyout  of  any  MAVERICK  missile 
is  stopped  (whether  or  not  it  has  exploded),  mvptr  is  a  pointer  to  the  MAVERICK  missile 
to  be  stopped. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

mvptr 

pointer  to 

MAVERICK  MISSILE 

Section  2.5.3.10 

Calls 

Function 

Where  Described 

missile_utiLcomm_stop_ 

missile 

Section  2.5.3.25.7 

Table  2.5>58:  missile_maverick_stop  Information. 


2.5.3.10  miss  maverick.h 

(7simnet/reTease/src/vehicle/libsrc/libmissile/miss_maverick.h) 

This  file  contains  structure  and  function  declarations  that  relate  speciEcally  to  the 
MAVERICK  missile  and  are  used  outside  the  missile  library. 


2.5.3.11  miss  stinger.c 

(./simnetAelease/src/vehicle/libsrc/libmissile/miss_stinger.c) 

This  file  contains  routines  which  fly  out  a  missile  with  the  characteristics  of  a  STINGER 
missile. 

Includes: 

"stdio.h" 

"math.h" 

"sim_types.h" 

"sim_dfns.h" 

"basic.h" 

"mun_type.h" 

"libmap.h" 

"libmatrix.h" 

"libnear.h" 

"miss_stinger.h" 

"libmiss_dfn.h" 

"libmissjoc.h" 


Defines: 

The  following  define  the  missile  characteristics: 
STINGER_BURNOUT_TIME 
STINGER_MAX_FLIGHT_TIME 
STINGER_LOCK_THRESHOLD 
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SPEED.O 

T:ffiTA_0 

IN\1’EST_DIST_SQ 

FCEZE_DIST_SQ 


Thefellow^g  constants  define  the  possible  states  of  the  STINGER_MISSILE: 
STBNGER_FREE 
STENGER_READY 
STffi^GER.FLYING 

Coeffknenfts  for  the  speed  polynomial  before  motor  burnout: 

stm{ger_bum_speed_coeff  [STINGER_BURN_SPEED_DEG  + 1] 

Coefficients  for  the  speed  polynomial  after  motor  burnout: 

stii«ger_coast_speed_coeff  [STINGER_COAST_SPEED_DEG  +  1] 

Memony  fcnr  the  missiles  is  declared  in  vehicle  specific  code.  During  initialization,  a  pointer 
is  asaj^ed  ao  this  memory,  then  all  memory  issu -s  are  handled  in  this  module. 
stinger_arrciy  is  a  pointer  to  missile  memory,  and  num  stingers  is  the  number  of  defined 
missiles. 


Static  tfunctkm  declarations: 

iiiissile_stinger_fly() 


2.5.3.11.1  missile_stinger_init 

ThisiG*utiiier  copies  the  parameters  into  variables  static  to  this  module  and  initializes  the  state 
of  all  miissiles.  It  also  initializes  the  proximity  fuse. 

The  pairam^rs  are  as  follows: 

missile _am^  -  a  pointer  to  an  array  of  STINGER  missiles  defined  in  vehicle 

specific  code. 

numjmssiies  -  the  number  of  missiles  defined  in  missile  array. 


1  Parameters  | 

Parairi»eter 

Where  Typedef  Declared 

missie  .array 

pointer  to  array  of 

STINGER  MISSILE 

Section  2.5.3.12 

num  n^issiles 

int 

Standard 

Internal  Variables 

Intermal  Variable 

Where  Typedef  Declared 

i 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

missile  fuze;  prox  init 

Section  2.5.3. 1.1 

Table  2.5-S')-  Tiissile_stinger_init  Information. 
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2.5.3.11.2  inissile_stinger_ready 

This  routine  finds,  if  possible,  a  missile  that  is  not  being  used,  puts  it  in  a  ready  state, 
clears  the  target  ID,  and  returns  a  pointer  to  it. 


1  Internal  Variables  I 

1  Internal  Variable 

Where  Typedef  Declared 

\l _ _ _ 

int 

Standard 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

&stinger_array[i] 

pointer  toSTINGER_MISSILE 

a  pointer  to  a  missiie  that  is 
currently  available 

NULL 

pointer  to  STINGER_MISSiLE 

no  missile  is  available 

Table  2.5-60:  missile_stinger_ready  Information. 


2.5.3.11.3  niissile_stinger_pre_Iaunch 


This  routine  is  called  after  a  missile  has  been  readied  and  before  it  has  been  launched.  It 
determines  if  the  seeker  head  can  see  a  target  and,  if  it  can  see  a  target,  stores  its  position. 
Parameters  are  represented  as  follows: 

sptr  -  a  pointer  to  the  missile  that  is  to  be  serviced. 

lauch _point  -  the  location  of  the  missile  in  world  coordinates. 

launchjo_world  -  the  transformation  matrix  of  the  missile  to  the  world. 
veh  list  -  the  vehicle  list  ED. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

SDtr 

pointer  to  STINGER  MISSILE 

Section  2.5.3.12 

launch _point 

VECTOR 

/simnet/common/include/prot 
ocol/sim  types. h 

launch_to_world 

T_MATRIX 

/simnet/common/include/prot 
ocol/sim  types. h 

veh  list 

int 

Standard 

Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

target 

pointer  to 

VehicleAppearanceVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

1  Calls  1 

Function 

Where  Described 

near_get_preferred_veh_ 
near  vector 

Section  2.5.17.2.4 

missile  target  pursuit 

Section  2.5.3.23.1 

Table  2.5-61:  missne_stinger_pre_launch  Information. 
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2.5.3.11.4  inissile_stinger_fire 

This  routine  performs  the  functions  specifically  related  to  the  firing  of  a  STINGER  missile. 
The  parameters  and  internal  variables  are  as  foUows; 


sptr 

launch jjoint 

launch  Jo _m>rld 
launchjpeed 

tube 

mptr 


-  a  pointer  to  the  STINGER  missile  that  is  to  be  launched. 

-  the  location,  in  world,  coordinates  from  which  the  missile  is 

launched. 

-  the  transformation  matrix  of  the  launch  platform  to  the  world. 

-  the  speed  of  the  launch  platform  (assumed  to  be  in  the  direction  of 

the  missile). 

-  the  tube  from  which  the  missile  was  launched. 

-  a  pointer  to  the  particular  generic  missile  pointed  to  by  sptr. 


Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

sptr 

pointer  to  STINGER  MISSILE 

Section  2.5.3.12 

launch jx>int 

VECTOR 

/simnet/common/include/prot 
ocol/sim  types.h 

launch_to_world 

T_MATRIX 

/simnet/common/include/prot 
ocol/sim  types.h 

launch_speed 

REAL 

/simnet/common/include/prot 
ocol/sim  types.h 

tube 

int 

Standard 

Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

1 

int 

Standard 

mptr 

pointer  to  MISSILE 

Section  2.5.3.2 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

TRUE 

int 

successful  launch 

FALSE 

int 

unsuccessful  launch 

1  Calls  1 

Function 

Where  Described 

vec  copy 

Section  2.6.2.59 

mat  copy 

Section  2.6.2.39.1 

missile  util  eval  poly 

Section  2.5.3.26.1 

missile  target  intercept  find 
_poly 

Section  2.5.3.17.3 

map_get_ammo_entry_from_ 
network  type 

Section  2.6.11.2.1 

missile_util_comm_fire_ 

missile 

Section  2.5.3.25.2 

Table  2.5*62:  missile_stinger_nre  Information. 
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2.5.3.11.5  inissile_stinger_fly_inissiles 

This  routine  flies  out  all  missiles  in  a  flying  state,  veh  list  is  the  vehicle  list  ID. 


1  Parameters  I 

1  Parameter 

Where  Typedef  Declared 

Iveh  list 

int 

Standard 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

missile  stinaer  fly 

Section  2.5.3.11.6 

Table  2.5-63:  missile_stinger_fly_missiles  Information. 
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2.5.3.11.6  inissile_stinger_fly 

This  routine  performs  the  functions  specifically  related  to  the  flying  out  of  a  STINGER 
missile.  The  parameters  are  as  follows: 

sptr  -  a  pointer  to  the  STINGER  missile  that  is  to  be  flown  out. 

vehjist  -  the  vehicle  list  ID. 

The  internal  variables  are  as  follows: 
mptr  -  a  pointer  to  the  generic  aspects  of  sptr. 

time  -  the  current  time  after  launch,  in  ticks. 

target  -  a  pointer  to  the  target's  appearance  packet 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

sptr 

pointer  to  STINGER  MISSILE 

Section  2.5.3.12 

veh  list 

int 

Standard 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

mptr 

reaister  pointer  to  MISSILE 

Section  2.5.3.2 

time 

REAL 

/simnet/common/include/prot 
ocol/sim  types. h 

target 

pointer  to 

VehicleAppearanceVarient 

/simnet/common/include/prot 
ocol/p  sim.h 

1  Calls  1 

Function 

Where  Described 

missile  util  eval  poly 

Section  2.5.3.26.1 

near_getj3referred_veh_ 
near  vector 

Section  2.5.17.2.4 

missile_target_interceptj5re_ 

burnout 

Section  2.5.3.17.1 

missile  taraet  intercept 

Section  2.5.3.17.2 

missile  taraet  unauided 

Section  2.5.3.24.1 

missile  util  flyout 

Section  2.5.3.27.1 

missile  stinaer  stop 

Section  2.5.3.11.7 

missile  fuze  prox 

Section  2.5.3.1.2 

Section  2.5.3.25.9 

Table  2.5-64: 


missile_stinger_fly  Information. 
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2.5.3.11.7  inissile_stinger_stop 

This  routine  causes  all  concerned  to  forget  about  the  missile,  releasing  missile  memory  for 
use  by  other  missiles.  It  also  clears  the  proximity  fuse  targets.  It  should  be  called  when 
the  flyout  of  any  STINGER  missile  is  stopped  (whether  or  not  it  has  exploded),  sptr  is  a 
pointer  to  the  STINGER  missile  that  is  to  stopped. 


1  Parameters  | 

1  Parameter 

Where  Typedef  Declared  I 

[m. _ 

pointer  to  STINGER  MISSILE 

Section  2.5.3.12  I 

1  Calls  1 

Function 

Where  Described 

missile_utiLcomm_stop_ 

missile 

Section  2.5.3.25.7 

missile  fuze  prox  stop 

Section  2.5.3.1.3 

Table  2.5-65:  missile_stinger_stop  Information. 


2.5.3.12  miss_stinger.h 

(./simnet/release/src/vehicle/libsrc/libmissile/miss_stinger.h) 

This  file  contains  stmcture  and  function  declarations  that  relate  specifically  to  the 
STINGER  missile  and  are  used  outside  the  missile  library. 


2.5.3.13  miss_tow.c 

(./sininet/reiease/src/vehicle/libsrc/libmissile/miss_tow.c) 

This  file  contains  routines  which  fly  out  a  missile  with  the  characteristics  of  a  TOW  missile. 

Includes; 

"stdio.h" 

"sim_types.h" 

"sim_dfns.h" 

"basic.h" 

"mun_type.h" 

"libmap.h" 

"libmatrix.h" 

"miss_tow.h" 

"libmiss_dfn.h" 

"libmissjoc.h" 

The  following  define  the  missile  characteristics: 

TOW_BURNOUT_TIME 

TOW_MAX_FLIGHT_TIME 

TOW_RANGE_LIMIT_TIME 

The  following  terms  set  the  order  of  the  polynomials  used  to  determine  the  speed  or  the 
cosine  of  the  maximum  allowed  turn  rate  of  the  missile  at  any  point  in  time. 
TOW_BURN_SPEED_DEG 
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TOW_CX)AST_SPEED_DEG 

TOW_BURN_TURN_DEG 

TOW_CX)AST_TURN_DEG 

Coefficients  for  the  speed  polynomial  before  motor  burnout: 

tow_bum_speed_coeff[TOW_BURN_SPEED_DEG+ 1  ] 

Coefficients  for  the  speed  polynomial  after  motor  burnout; 

tow_coast_sp^_coeffrrOW_COAST_SPEED_DEG+ 1  ] 

The  following  are  declared  as  static  My\X_COS_COEFF: 
tow_bum_tum_coeff 
tow_coast_tum_coeff 

The  following  function  is  declared  as  static: 
missi  le_to  w_stop  ( ) 


2.5.3.13.1  missile_tow_init 

This  routine  initializes  the  state  of  the  missile  to  indicate  that  it  is  available,  and  sets  values 
that  never  change,  tptr  is  a  pointer  to  the  TOW  missile  to  be  initialized. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

tptr 

pointer  to  TOW  MISSILE 

Section  2.5.3.14 

Table  2.5«66:  missile  tow  init  Information. 
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2.5.3.13.2 


missile  tow  fire 


This  routine  performs  the  functions  specifically  related  to  the  firing  of  a  TOW  missile. 


The  parameters  are  defined  as  follows: 

tptr  -  a  pointer  to  the  TOW  missile  to  be  fired. 

launch _point  -  the  location,  in  world  coordinates,  from  which  the  missile  is 

launched. 

loc_sight_to_world  -  the  sight  to  world  transformation  matrix  used  only  in  this  routine. 
launch_speed  -  the  sp^  of  the  launch  platform  (assumed  to  be  in  the  direction  of 

the  missile). 

tube  -  the  tube  from  which  the  missile  was  launched. 

The  internal  variable  is  defined  as  follows: 

mptr  -  a  pointer  to  the  particular  generic  missile  pointed  to  by  tptr. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

tptr 

pointer  to  TOW  MISSILE 

Section  2.5. 3. 6 

launchjxiint 

VECTOR 

/simnet/common/include/prot 
ocol/sim  types. h 

loc_sight_to_world 

T_MATRIX 

/simnet/common/include/prot 
ocol/sim  types. h 

launch_speed 

REAL 

/simnet/common/include/prot 
ocol/sim  types. h 

rangejojntercept 

REAL 

/simnet/common/include/prot 
ocol/sim  _types.h 

tube 

int 

Standard 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

mptr 

pointer  to  MISSILE 

Section  2.5.3. 2 

Calls 

Function 

Where  Described 

vec  copy 

Section  2.6.2.59 

mat  copy 

Section  2.6.2.39.1 

missile_util_comm_fire_ 

missile 

Section  2.5.3.25.2 

missile  util  eval  poly 

Section  2.5.3.26.1 

map_get_ammo_entry_from_ 
network  type 

Section  2.6.11.2.1 

Table  2.5-67:  missile  tow  fire  Information. 
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2.5.3.13.3  inissile_tow_fIy 

This  routine  performs  the  functions  specifically  related  to  the  flying  a  TOW  missile. 

The  parameters  are  defined  as  follows: 

ptr  -  a  pointer  to  the  TOW  missile  that  is  to  be  flown  out. 

sight  location  -  the  location,  in  world  coordinates,  of  the  gunner's  sight. 

loc  sight  to _world  -  the  sight  to  world  transformation  matrix  used  only  in  this  routine. 

The  internal  variables  are  defined  as  follows; 

mptr  -  a  pointer  to  the  generic  aspects  of  tptr. 

time  -  the  current  time  after  launch,  in  ticks. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

tptr 

pointer  to  TOW  MISSILE 

Section  2.5.3.6 

sight_location 

VECTOR 

/simnet/common/include/prot 
ocol/sim  types. h 

loc_sight_to_world 

T_MATRIX 

/simnet/common/include/prot 
ocol/sim  types. h 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

mptr 

pointer  to  MISSILE 

Section  2. 5. 3. 2 

time 

REAL 

/simnet/common/include/prot 
ocol/sim  types. h 

Calls 

Function 

Where  Described 

missile  util  eval  poly 

Section  2.5.3.26.1 

missile  util  eval  cos  coeff 

Section  2.5.3.26.2 

missile  taraet  level  los 

Section  2.5.3.18.1 

missile  taraet  around 

Section  2.5.3.16.1 

missile  util  flyout 

Section  2.5.3.27.1 

missile  tow  stop 

Section  2.5.3.13.4 

missile_utiLcomm_check_ 

detonate 

Section  2.5.3.25.9 

missile_util_comm_check_ 

intersection 

Section  2.5.3.25.8 

Table  2.5-68:  missile  tow_fly  Information. 
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2.5.3.13.4  missile_tow_stop 

This  routine  causes  all  concerned  to  forget  about  the  missile,  releasing  missile  memory  for 
use  by  other  missiles.  It  should  be  called  when  the  flyout  of  any  TOW  missile  is  stopped 
(whether  or  not  it  has  exploded.)  Note  that  this  routine  can  only  be  called  within  this 
module,  tptr  is  a  pointer  to  a  missile  that  is  to  be  stopped. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

tptr 

pointer  to  TOW  MISSILE 

Section  2.5.3.14 

1  Calls  1 

Function 

Where  Described 

missile_util_comm_stop_ 

missile 

Section  2.5.3.25.7 

Table  2.5-69:  missiIe_tow_stop  Information. 


2.5.3.13.5  missiIe_tow_cut_wire 

This  routine  sets  a  flag  indicating  that  the  guidance  wire  to  this  missile  is  cut.  tptr  is  a 
pointer  to  the  TOW  missile  whose  wire  is  to  be  cut. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

tptr 

pointer  to  TOW  MISSILE 

Section  2.5.3.14 

Table  2.5-70:  missile_tow_cut_wire  Information. 


2.5.3  14  miss_tow.h 

(./simnet/release/src/vehicle/libsrcAibmissile/miss_tow.h) 

This  file  contains  structure  and  function  declarations  that  relate  specifically  to  the  TOW 
missile  and  are  used  outside  the  missile  library. 


2.5.3.15  targ_agm.c 

(./simnet^lease/src/vehicle/libsrc/libmissile/targ_agm.c) 

This  file  contains  the  routines  which  steer  missiles  on  an  air  to  ground  missile  trajectory. 

Includes: 

"stdio.h" 

"math.h" 

"sim_types.h" 

"sim_dfns.h" 

"libmatrix.h" 

libmiss_dfn.h" 
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Defines: 

SPEED_FACrOR 

TERMINAL_DIST_SQ 

Declarations: 

agm_seek() 


2.5.3.15.1  inissile_target_agm 

This  routine  sets  the  target  to  a  vector  which  will  yield  an  air  to  ground  missile  trajectory. 

The  parameters  are  defined  as  follows: 

mptr  -  a  pointer  to  a  structure  of  type  MISSILE  which  contains  all  of  the 

information  that  describes  a  missile's  state  at  a  given  time. 

target  -  the  location,  in  world  coordinates,  which  of  the  missile's  target.  If 

target  is  NULL,  no  target  has  been  designated. 

sin  unguide  -  the  sine  of  the  angle  that  the  flight  path  makes  with  the  horizontal 

plane  when  the  missile  is  not  guided. 

cos  unguide  -  the  cosine  of  the  angle  that  the  flight  path  makes  with  the  horizontal 

plane  when  the  missile  is  not  guided. 

sin  climb  -  the  sine  of  the  climb  angle,  the  angle  that  the  missile  must  turn  up 

in  a  sinle  time  step  in  order  to  climb  with  a  constantly 
increasing  pitch  rate. 

cos  climb  -  the  cosine  of  the  climb  angle. 

sinjock  -  the  sine  of  the  lock  angle,  the  angle  between  the  missile's  direction 

of  flight  and  the  direction  to  the  target,  which  the  missile 
attempts  to  hold  constant. 

cos  Jock  -  the  cosine  of  the  lock  angle. 

cosjerm  -  the  cosine  of  the  angle  which  defines  the  terminal  guidance  cone, 

both  above  and  below  the  target.  If  the  missile  is  inside 
either  of  these  cones,  the  missile  will  be  terminally  guided. 

cos  lose  -  the  cosine  of  the  angle  which  sets  the  field  of  view  of  the  missile. 

If  the  target  is  outside  the  missile's  field  of  view,  the  missile 
will  lose  its  lock  on  the  target. 

Internal  variables  are  defined  as  follows: 

velocity  -  a  pointer  to  the  normalized  velocity  vector  of  the  missile  (the 

second  row  of  the  missile's  orientation  matrix). 

targ  vec  -  a  normalized  vector  which  points  from  the  missile  to  the  target. 

traj  vec  -  a  normalized  vector  which  points  in  the  desired  flight  direction. 

sinjarg  sq  -  the  square  of  the  sine  of  the  angle  that  targ_yec  m^es  with  the 

horizontal  plane. 
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Parameter 


target 


sin_unguide 


cos_unguide 


sin_climb 


cos  climb 


sin  lock 


cos  lock 


cos  term 


cos  lose 


Parameters 


inter  to  MISSILE 


VECTOR 


Where  Typedef  Declared 


Section  2.5. 3.2 


/simnet/common/include/prot 
ocol/sim  types,  h 


/simnet/common/include/prot 
ocol/sim  types. h 


/simnet/common/include/prot 
ocol/sim  types. h 


/simnet/common/include/prot 
ocol/sim  types.h 


/simnet/common/include/prot 
ocol/sim  types.h 


/simnet/common/include/prot 
ocol/sim  types.h 


/simnet/common/include/prot 
ocol/sim  types.h 


/simnet/common/include/prot 
ocol/sim  types.h 


/simnet/common/include/prot 
ocol/sim  types.h 


Internal  Variable 


temp 


velocity 


targ_vec 


traLvec 


sin_targ_sq 


Internal  Variables 


register  REAL 


register  pointer  to  REAL 


VECTOR 


VECTOR 


REAL 


Where  Tvpedef  Declared 


/simnet/common/include/prot 
ocol/sim  types.h 


/simnet/common/include/prot 
ocol/sim  types.h 


/simnet/common/includfc/prot 
ocol/sim  types.h 


/simnet/common/include/prot 
ocol/sim  types.h 


/simnet/common/include/prot 
ocol/sim  types.h 


Function 


aom  seek 


vec  sub 


vec  CO 


vec  dot  prod 


vec  scale 


vec  add 


Where 


Section 


Section 


Section 


Section 


Section 


Section 


Calls 


Described 


2.5.3.15.2 


2.6.2.65 


2.6.2.59 


2.6.2.54 


2.6.2.64 


2.6.2.57 


Table  2.5-71:  inissne_target_agni  Informatics. 
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2.5.3.15.2  inissile_agni_seek 

This  routine  sets  a  new  target  point  so  that  the  missile  will  fly  in  a  straight  line  at  a  specified 

angle  with  respect  to  the  horizontal  plane. 

The  parameters  are  defined  as  follows: 

mptr  -  a  pointer  to  a  structure  of  type  MISSILE  which  contains  all  of  the 

information  that  describes  a  missile's  state  at  a  given  time. 

sin  unguide  -  the  sine  of  the  angle  that  the  flight  path  makes  with  the  horizontal 

plane  when  the  missile  is  not  guided. 

cos  unguide  -  the  cosine  of  the  angle  that  the  flight  path  makes  with  the  horizontal 

plane  when  the  missile  is  not  guided. 

The  internal  variable  of  interest  is  defined  as  follows: 

traj  vec  -  the  normalized  vector  which  describes  the  desired  trajectory  of  the 

missile. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

mptr 

pointer  to  MISSILE 

Section  2. 5. 3.2 

sin_unguide 

REAL 

/simnet/common/include/prot 
ocol/sim  tvpes.h 

cos_unguide 

REAL 

/simnet/common/include/prot 
ocol/sim  tvpes.h 

Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

temp 

register  REAL 

/simnet/common/include/prot 

ocol/simjypes.h 

trai_vec 

VECTOR 

/simnet/common/include/prot 
ocol/sim  types. h 

1  Calls  1 

Function 

Where  Described 

vec  scale 

Section  2.6.2.64 

vec  add 

Section  2.6.2.57 

Table  2.5-72:  inissile_agm_seek  Information. 
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2.5.3.16  targ  ground.c 

(./simnet^ease/src/vehicle/libsrcAibmissile/targ_ground.c) 

This  file  contains  the  routine  that  steers  the  missile  to  the  ground. 

Includes: 

"sim_types.h" 

"sim_dfns.h" 

"libmatrix.h" 

"libmiss_dfn.h" 


2.5.3.16.1  inissile_target_ground 

This  routine  sets  the  target  to  a  point  at  or  below  the  ground  directly  below  the  missile. 
mptr  is  a  pointer  to  a  stmcture  of  type  MISSILE  which  contains  all  of  the  information  that 
describes  a  missile's  state  at  a  given  time. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

mptr 

pointer  to  MISSILE 

Section  2.5. 3.2 

Calls 

Function 

Where  Described 

vec_copv 

Section  2.6.2.59 

Table  2.5-73:  missile_target_ground  Information. 


2.5.3.17  targ  intrcpt.c 

(./simnet^ease/src/vehicle/libsrcAibmissile/targ_intrcpt.c) 

This  file  contains  the  routines  that  steer  a  missile  on  an  intercept  trajectory. 

Includes: 

"stdio.h" 

"math.h" 

"sim_types.h" 

"p_sim,h’' 

"libmatrix.h" 

"libmiss_dfn.h" 

"libmiss_loc.h" 


Defines: 

MAX_DEG_SQ 

INTER_TOLERANCE 

INTER_MAX_ITERATION 


Declarations; 

callocO 
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2.5.3.17.1  missile_ta  rget_in  tercept_pre_bu  rnout 

This  routine  sets  the  target  to  a  point  which  will  cause  the  missile  whose  motor  has  not 
burned  out  to  intercept  die  target  It  does  so  by  manipulating  data  so  that 
iiiissile_target_intercept()  will  work  correcdy  before  motor  burnout.  The  routine 
iiiissile_targeMntercept()  expects  the  missile  to  have  a  range  profile  which  is 
described  by  a  »ngle  polynomial.  The  missile  model  uses  different  polynomials  before  and 
after  motor  burnout  This  routine  finds  a  point  in  space  where  the  missile  would  have  to  be 
in  order  to  arrive  at  the  point  in  space  where  the  motor  will  bum  out  using  the  coast  phase 
equations.  This  point  is  sent  to  missile_target_intercept{). 


The  parameters  are  defined  as  follows: 


mptr 

tptr 

bumjrange 


burn  time 

burndeg 

rangel 

range_2 

deg 


•  a  pointer  to  a  structure  of  type  MISSILE  which  contains  all  of  the 
information  that  describes  a  missile's  state  at  a  given  time. 

-  a  pointer  to  the  vehicle  appearance  packet  of  the  target  vehicle. 

-  an  array  containing  the  coefficients  of  a  polynomial  which  yields 

die  missile  range  before  motor  burnout,  given  the  time  of 
flight. 

-  the  time  of  flight  when  the  motor  bums  out. 

-  the  degree  of  burn  range. 

-  an  array  containing  the  coefficients  of  a  polynomial  which  yields 

missile  range  after  motor  burnout,  given  time  of  flight. 

-  an  array  containing  the  coefficients  of  a  polynomial  which  is  the 

square  of  that  of  range  l. 

-  the  degree  of  range  l. 


The  internal  variables  are  defined  as  follows: 

delta  jange  -  the  difference  between  the  distance  that  the  missile  will  fly  from  the 

current  time  to  the  burnout  time  and  the  distance  it  would  fly 
if  it  were  using  the  coast  phase  equations. 

temp  location  -  the  actual  current  missile  location. 

deltajocation  -  the  vector  from  the  missile's  actual  current  position  to  its  position 

if  the  coast  phase  equations  were  used. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

mptr 

pointer  to  MISSILE 

Section  2  5.3.2 

tptr 

pointer  to 

Vehicle  AppearanceVariant 

/simnet/cc  mmon/include/prot 
ocoi/p  sim.h 

burn_range 

array  of  REAL 

/simnet/common/include/prot 
ocol/sim  types. h 

burnjime 

REAL 

/simnet/common/include/prot 
ocol/sim  types. h 

burn  dea 

int 

Standard 

range_1 

array  of  REAL 

/simnet/common/include/prot 
ocol/sim  types.h 

tange_2 

array  of  REAL 

/simnet/common/include/prot 
ocol/sim  types.h 

deo 

int 

Standard 
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Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

delta_range 

REAL 

/simnet/common/include/prot 
ocol/sim  tvpes.h 

tempjocation 

VECTOR 

/simnet/common/include/prot 
ocol/sim  tvpes.h 

deltajocation 

VECTOR 

/simnet/common/include/prot 
ocol/sim  tvpes.h 

1  Calls  1 

Function 

Where  Described 

vec  coDV 

Section  2.6.2.59 

1 

Section  2.5.3.26.1 

vec  scale 

Section  2.6.2.64 

vec  add 

Section  2.6.2.57 

missile  taraet  intercept 

Section  2.5.3.17.2 

Table  2.5-74:  inissile_target_intercept_pre_burnout  Information. 

2.5.3.17.2  missile_target_intercept 

This  routine  sets  the  target  to  a  point  which  will  cause  the  missile  to  intercept  the  target. 

The  parameters  are  defined  as  follows: 

mptr  -  a  pointer  to  a  structure  of  type  MISSILE  which  contains  all  of  the 

information  that  describes  a  missile's  state  at  a  given  time. 

tptr  -  a  pointer  to  the  vehicle  appearance  packet  of  the  target  vehicle. 

range_l  -  an  array  containing  the  coefficients  of  a  polynomial  which  yields 

missile  range  aftCT  motor  burnout,  given  time  of  flight. 

range_2  -  an  array  containing  the  coefficients  of  a  polynomial  which  is  the 

square  of  that  of  range _L 

deg  -  the  degree  of  the  polynomial  of  range  l. 

The  internal  variables  are  defined  as  follows: 

sqjjoly  -  a  pointer  to  an  array  which  will  contain  the  coefficients  of  the 

polynomial  which  yields  the  square  of  the  distance  between 
the  target's  current  position  and  the  predicted  intercept  point. 

range  O  -  the  calculated  current  range. 

primary _sq_polylMAXJ)EG_SQ]  -  the  preferred  place  to  store  the  array  pointed  to  by 

sq_poly. 

delta  -  the  vector  firom  the  current  missile  position  to  the  target. 

targ  vel  -  the  velocity  vector  of  the  target. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

mptr 

pointer  to  MISSILE 

Section  2.5.3.2 

tptr 

pointer  to 

VehicleAppearanceVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

range_1 

array  of  REAL 

/simnet/common/include/prot 
ocol/sim  tvpes.h 

range_2 

array  of  REAL 

/simnet/common/include/prot 
ocol/sim  tvpes.h 

deo 

int 

Standard 
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Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

i 

reqister  int 

Standard 

temp_var 

register  REAL 

/simnet/common/include/prot 
ocol/sim  types,  h 

scLpoly 

pointer  to  register  REAL 

/simnet/common/include/prot 
ocol/sim  types,  h 

range_0 

REAL 

/simnet/common/inciude/prot 
ocol/sim  types,  h 

primary_sq_poly 

array  MAX_DEG_SQ  of  REAL 

/simnet/common/include/prot 
ocol/sim  types,  h 

delta 

VECTOR 

/simnet/common/include/prot 
ocol/sim  types,  h 

targ_vel 

VECTOR 

/simnet/common/include/prot 
ocol/sim  types  h 

temp_vec 

VECTOR 

/simnet/common/inciude/prot 
ocol/sim  types,  h 

two  dea 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

missile  util  eval  oolv 

Section  2.5.3.26.1 

f2d  vec  copy 

Section  2.6.2.10.1 

vec  copy 

Section  2.6.2.59 

vec  sub 

Section  2.6.2.65 

vec  dot  prod 

Section  2.6.2.54 

vec  scale 

Section  2.6.2.64 

missile_utiLeval_newton_ 

raphson 

Section  2.5.3.26.3 

vec  add 

Section  2.6.2.57 

Table  2.5-75:  missile_target_intercept  Information. 
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2.5.3.17.3  niissile_target_intercept_find_poIy 

This  routine  finds  the  range  and  range  squared  polynomials  for  a  missile  given  its  base 
velocity  profile  and  initial  speed. 

The  parameters  are  defined  as  follows: 


speed_deg 

initspeed 

speed 

range 

range J. 


-  the  degree  of  the  velocity  profile  polynomial. 

-  the  initial  speed  of  the  missile. 

-  an  array  which  contains  the  coefficients  of  the  velocity  profile 

polynomial. 

-  an  array  which  will  contain  the  coefficients  of  the  range  profile 

polynomial. 

-  an  array  which  will  contain  the  coefficients  of  the  square  of  the 

range  profile  polynomial. 


Parameters 


Parameter 


soeed  de 


init_speed 


speed 


range_2 


lEIT! 


e 


int 


REAL 


array  of  REAL 


array  of  REAL 


array  of  REAL 


Where  Tvpedef  Declared 


Standard 


/simnet/common/mciL'de/prot 
ocol/sim  tvoes.h 


/s  imnet/co  mmo  n/include/prot 
ocol/sim  tvoes.h 


/simnet/common/mclude/prot 
ocol/sim  tvoes.h 


/simnet/common/include/prot 
ocol/sim  tvoes.h 


Internal  variable 


Internal  Variables 


EITiX 


Where  Tvpedef  Declared 


Standard 


Standard 


Table  2.5-76:  missiIe_targeMntercept_find_poIy  Information. 
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2.5.3.18  targ  lev  los.c 

(ysininet/reTease7src/vehicle/libsrcAibmissile/targ_lev_los.c) 

This  file  contains  the  routine  which  &ids  a  line  of  sight  target,  with  provisions  for  a  canted 
sight. 

Includes: 

''math.h" 

"sim_types.h" 

"sun_(tfns.h" 

"Ubniatrix.h" 

''libiniss_dfn.h" 


2.5.3.18.1  missile_targeMevel_los 

This  routine  finds  a  point  in  space  to  which  the  missile  can  steer,  which  will  return  it  to  the 
line  of  sight  The  missile  assumes  that  the  sight  is  level;  therefore,  steering  commands 
from  a  canted  sight  will  not  steer  correctly.  Tliis  routine  provides  for  this  behavior  by 
generating  a  leveled  coordinate  system. 

The  location  of  the  missile  relative  to  the  sight,  in  sight  and  level  coordinates,  is  found. 

The  target  is  a  point  on  what  the  missile  believes  to  be  the  line  of  sight,  located  at  a  distance 
along  the  line  equal  to  the  missile's  current  position  plus  the  distance  it  will  fly  during  the 
next  time  step.  Selecting  this  point  guarantees  that,  if  it  is  within  the  turning  capabilities  of 
the  missile,  the  missile  will  not  overfly  this  believed  line  of  sight,  and  will  return  almost  as 
quickly  as  possible.  The  X  and  Z  values  of  rel_sightJocation  are  essentially  errors  fed  to 
the  missile.  It  believes  these  errors  to  be  X  and  Y  values  in  the  level  coordinate  system. 
The  believed  line  of  sight  is,  then,  the  line  from  the  sight  location  (the  origin  of  both  the 
sight  and  level  coordinate  systems)  to  the  point  found  by  subtracting  the  X  and  Z  values  in 
rel_sight_location  from  the  X  and  Z  values  in  reljevel  location.  TTiis  point  is  expressed  in 
level  coordinates.  It  is  then  converted  to  world  coordinates,  and  saved. 


The  parameters  are  defined  as  follows: 

mptr  -  a  pointer  to  a  structure  of  type  MISSILE  which  contains  all  of  the 

information  that  describes  a  missile's  state  at  a  given  time. 
sightJocaAon  -  the  location  of  the  sight,  in  world  coordinates. 

loc  sight  Jo _world  -  a  transformation  matrix  which  will  transform  a  vector  expressed  in 

sight  coordinates  to  one  expressed  in  world  coordinates. 


The  internal  variables  are  defined  as  follows: 


loc  world  to  sight 
leveljoworlcl 

world  to  level 

rel  level Jocation 
rel  sight  locatior^. 


-  the  matrix  used  to  convert  from  world  coordinates  to  sight 

coordinates.  It  is  the  transpose  of  loc  sight  to  world. 

-  the  matrix  used  to  convert  from  a  coordinate  system  whose  Y-axis 

is  aligned  with  the  line  of  sight  and  X-axis  lies  in  the  world 
XY  plane  (level  coordinates)  to  world  coordinates. 

-  the  matrix  used  to  convert  from  world  coordinates  to  level 

coordinates.  It  is  the  transpose  of  level  to  world. 

-  the  location  of  the  missile  relative  to  the  sight,  in  level  coordinates. 

-  the  location  of  the  missile  relative  to  the  sight,  in  sight  coordinates. 
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1  Parameters  I 

Parameter 

Where  Typedef  Declared 

motr 

pointer  to  MISSILE 

Section  2.5.3.2 

sightjocation 

VECTOR 

/simnet/common/include/prot 

ocol/simjypes.h 

loc_slght_to_world 

T_MATRIX 

/simnet/common/include/prot 
ocol/sim  types,  h 

1  Internal  Variables  I 

Internal  Variable 

Type 

Where  Typedef  Declared 

loc_world_to_sight 

T_MATRIX 

/simnet/common/include/prot 
ocol/sim  types.h 

leveLto_world 

T_MATRIX 

/simnet/common/include/prot 
ocol/sim  types.h 

world_toJevel 

T_MATRIX 

/simnet/common/include/prot 
ocol/sim  types.h 

relJeveLlocation 

VECTOR 

/simnet/common/include/prot 
ocol/sim  types.h 

rel_sight_location 

VECTOR 

/simnet/common/include/prot 
ocol/sim  types.h 

1  Calls  1 

Function 

Where  Described 

mat  level  init 

Section  2.6.2.46.1 

mat.  transpose 

Section  2.6.2.51.1 

vec  sub 

Section  2.6.2.65 

vec  mat  mul 

Section  2.6.2.56.1 

vec  add 

Section  2.6.2.57 

Table  2.5-77:  missile_targeMeveI_los  Information. 
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2.5.3.19  targ  los.c 

(ysimnel/r^ease/srcA'ehicle/Iibsrc/libmissile/targ_los.c) 

This  file  contains  the  routine  which  finds  a  line  of  sight  target. 

Includes: 

"sim_types.h" 

"sim_(tfns.h" 

"Ubmatrix.h" 

"libmiss_dfn.h" 


2.5.3.19.1  inissile_target_los 

This  routine  finds  a  point  in  space  to  which  the  missile  can  steer,  which  will  return  it  to  the 
line  of  sight. 

The  location  of  the  missile  relative  to  the  sight,  in  sight  coordinates,  is  found.  The  target  is 
a  point  on  the  line  of  sight,  located  at  a  distance  along  the  line  equal  to  the  missile's  current 
position  plus  the  distance  it  will  fly  during  the  next  time  step.  Selecting  this  point 
guarantees  that,  if  it  is  within  the  tunung  capabilities  of  the  missile,  the  missile  will  not 
overfly  this  believed  line  of  sight,  and  will  return  almost  as  quickly  as  possible.  This  point 
is  converted  to  world  coordinates,  and  saved. 

The  parameters  are  defined  as  follows: 

mptr  -  a  pointer  to  a  structure  of  type  MISSILE  which  contains  all  of  the 

information  that  describes  a  missile’s  sta^e  at  a  given  time. 
sightjocation  -  the  location  of  the  sight,  in  world  coordinates. 

loc_Fightjo_world  -  a  transformation  matrix  which  will  transform  a  vector  expressed  in 
~  sight  coordinates  to  one  expressed  in  world  coordinates. 

The  internal  variables  are  defined  as  follows: 

loc_world_to  sight  -  the  transpose  of  loc  sight  to _world,  the  matrix  used  to  convert 

from  world  coordinates  to  sight  coordinates. 

reljocation  -  the  location  of  the  missile  relative  to  the  sight,  in  sight  coordinates. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

motr 

pointer  to  MISSILE 

Section  2.5. 3.2 

sightjocation 

VECTOR 

/simnet/common/include/prol 
ocol/sim  types. h 

loc_sightjo_world 

T_MATRIX 

/simnet/common/include/prot 
ocol/sim  types. h 

Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

loc_worldJo_sighi 

T_MATRIX 

/simnet/common/include/prot 
ocol/sim  types,  h 

rel_location 

VECTOR 

/simnet/common/include/prot 
ocol/sim  types. h 

loot) 
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Calls 

Function 

Where  Described 

mat  transDose 

Section  2.6.2.51.1 

vec  sub 

Section  2.6.2.65 

vec  mat  mul 

Section  2.6.2.56.1 

vec  add 

Section  2.6.2.57 

Table  2.5*78:  inissile_targeMos  Information. 


2.5.3.20  targ  losbias.c 

(ysimnet^ease/srcA'ehicle/libsrc/libmissile/targ_losbias.c) 

This  file  contains  the  routine  which  finds  a  line  of  sight  target. 

Includes: 

"sim_types.h" 

"sim_dfns.h" 

"libmatrix.h" 

"libmiss_dfn.h" 

2.5.3.20.1  missile_target_Ios_bias 

This  routine  finds  a  point  in  space  to  which  the  missile  can  steer,  returning  it  to  the  line  of 
sight. 

The  location  of  the  missile  relative  to  the  sight,  in  sight  coordinates,  is  found.  The  target  is 
biased  from  a  point  on  the  line  of  sight.  This  i^int  is  located  at  a  distance  equal  to  the 
missiles  current  position  plus  the  distance  it  will  fly  during  the  next  time  step.  Selecting 
this  point  guarantees  that,  if  it  is  within  the  turning  capabilities  of  the  missile,  the  missile 
will  not  overfly  the  line  of  sight,  and  it  will  return  almost  as  quickly  as  possible.  The 
amount  of  bias  is  input,  converted  to  world  coordinates,  and  saved. 

The  parameters  are  defined  as  follows: 

mptr  -  a  pointer  to  a  structure  of  type  MISSILE  which  contains  all  of  the 

information  that  describes  a  missile's  state  at  a  given  time. 
sight Jocation  -  the  location  of  the  sight,  in  world  coordinates. 

loc_sightjo_world  -  a  transformation  matrix  which  will  transform  a  vector  expressed  in 

sight  coordinates  to  one  expressed  in  world  coordinates. 
biasjc  -  the  horizontal  distance  (in  meters)  that  the  missile  is  to  be 

displaced  off  the  line  of  sight. 

biasjL  -  the  vertical  distance  (in  meters)  that  the  missile  is  to  be  displaced 

off  the  line  of  sight. 

The  internal  variables  are  defined  as  follows: 

loc  world  to  sight  -  the  matrix  used  to  convert  from  world  coordinates  to  sight 

coordinates.  It  is  the  transpose  of  loc  sight  to  jvorld. 
reljocation  •  the  location  of  the  missile  relative  to  the  sight,  in  sight  coordinates. 
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1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

motr 

pointer  to  MISSILE 

Section  2.5. 3.2 

sightjocation 

VECTOR 

/simnet/common/include/prot 
ocol/sim  types. h 

loc_sight_to_world 

T_MATRIX 

/simnet/common/include/prot 
ocol/sim  types. h 

bias_x 

REAL 

/simnet/common/include/prot 
ocol/sim  types,  h 

bias_z 

REAL 

/simnet/common/include/prot 
ocol/sim  types,  h 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

loc_world_to_sight 

T_MATRIX 

/simnet/common/include/prot 
ocol/sim  types.h 

reLlocation 

VECTOR 

/simnet/common/include/prot 
ocol/sim  types.h 

Calls 

Function 

Where  Described 

mat  transpose 

Section  2.6.2.51.1 

vec  sub 

Section  2.6.2.65 

vec  mat  mul 

Section  2.6.2.56.1 

vec  add 

Section  2.6.2.57 

Table  2.5-79:  missiIe_targeMos_bias  Information. 
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2.5.3.21  targ  point.c 

(ysimnet/r5ease/src/vehicle/libsrc/libmissile/targ_pomt.c) 

This  file  contains  the  routine  which  causes  a  missile  to  fly  directly  at  a  vehicle. 


Includes: 

"sim_types.h" 

"libmatrix.h" 

"libmiss_dfn,h" 


2.5.3.21.1  inissile_target_point 

This  routine  steers  the  missile  directly  to  the  target,  mptr  is  a  pointer  to  a  structure  of  type 
MISSILE  which  contains  all  of  the  information  that  describes  a  missile's  state  at  a  given 
time,  loc  is  the  x,  y,  z  coordinates  of  the  target 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

mptr 

pointer  to  MISSILE 

Section  2.5. 3. 2 

loc 

VECTOR 

/simnet/oommon.'include/prot 
ocol/sim  types. h 

Calls 

Function 

Where  Described 

vec  copy 

Section  2.6.2.59 

Table  2.5*80:  inissile_target_point  Information. 
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2.5.3.22  tar{g_pursuit.c 

(ysiinneiARilease/src/vehicl^bsrc/libmissile/targ_pursuit.c) 

This  file  contains  ithe  routine  which  causes  a  missile  to  fly  directly  at  a  vehicle. 

Includes: 

"p_»nLh,"' 

"libmatmLA" 

"libmiss_c^n.h" 


2.5.3.22.1  iDlii^ile_target_pursuit 

This  routine  steals  the  missile  directly  to  the  target,  mptr  is  a  pointer  to  a  structure  of  type 
MISSILE  which,  ccMitains  all  of  the  information  that  describes  a  missile's  state  at  a  given 
time,  tp/r  is  a  ponnter  to  a  target's  vehicle  appearance  packet. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

mptr 

pointer  to  MISSILE 

Section  2.5. 3.2 

tptr 

pointer  to 

VehicleAppearanceVariant 

/simnet/common/inciude/prot 
ocoi/p  sim.h 

1  Calls  1 

Function 

Where  Described 

vec  copy 

Section  2.6.2.59 

T:able  2.5*81:  niissile_target_point  Information. 
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2.5.3.23  targ  unguide.c 

(./simnet/r^ease/sic/vehicle/libsrc/libniissile/targ_unguide.c) 

This  file  contains  the  routine  which  causes  a  missile  to  continue  to  fly  in  the  same  direction. 


Includes: 

"Ubmatrix.h" 
"libmiss  dfn.h" 


Defines: 

SPEED_FACrOR 


2.5.3.23.1  missile_target_unguided 

This  routine  finds  a  point  in  space  directly  in  front  of  the  missile,  mptr  is  a  pointer  to  a 
structure  of  type  MISSILE  which  contains  all  of  the  information  that  describes  a  missile's 
state  at  a  given  time. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

motr 

DOinter  to  MISSILE 

Section  2.5.3.2 

Calls 

Function 

Where  Described 

vec  scale 

Section  2.6.2.64 

vec  add 

Section  2.6.2.57 

Table  2.5-82:  missile_target_unguided  Information. 
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2.5.3.24  4if  _c0in]nuc 

(7!siraaiicfr''%^lease/9X^^hicle/Ubsic/UbinissiIe/udl_cornm.c) 

This  file  conniiKs^  yontmes  wfiiich  provide  communication  between  the  missiles,  the  CIG, 
acd  tile  netw-^  rrhe  objectt  is  to  make  this  communication  transparent  to  the  missiles.  A 
smictuie  ms^/m£SsiIe_conimt,  is  established  to  facilitate  this  communication.  Each  missile 
in  fli^t  iscsifi^red  a.ixdsalle  ID  which  is  an  index  into  this  array.  The  stucture  contains  an 
ervent  ID  eatc'yjri&^icfa  is  usa£  to  communicate  with  the  rest  of  the  world.  Other  entries  in 
die  structure  ^avrvade  a  meanis  of  passing  information  between  the  missiles  and  tiie  rest  of 
the  world.  Tlan  number  of  naissUes  in  flight  is  limited  to  the  number  of  elements  in 
missiIe_comjm.lTtm  is  the  GK'JLY  place  in  the  missile  software  where  the  number  of 
missiles  infiyUt  t  is  limited. 

Includes: 

"matihif 

"siin._:^%s.h:" 

"sim_jlbs:s.h" 

"sim_jiic.i3rD&ir 
"mass jtilfdc.lt'’ 

’’dgi_sile^h" 

"sim_j^_:'if.h’' 

"basidr 

"libewBfcih" 

"libinnpLh.h" 

"libnuaixix.h" 

"libna^i  " 

"Ubhiofiht' 

"Ubkanh»  ’ 

"libim^i: " 

"lilM»elra{>rk.h" 

"libnaiBLt?<ifh.h" 

"liboKiii^g^Ji" 

Defines: 

MISSJ&?.!PTY 
MISSJE.-YING 
MISSJSfn^rERSECEED 
MISSJESJ  DETONATED 
TAN_» 

VIEWiKUANGE_2 

missile.c<69mm01AX_MISSILE_ID] 
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2.5.3.24.1  miss!  le_util_coinin_init 

This  routine  sets  every  entry  in  missile.comm  to  MISS_EMPTY,  and  the  event_id  to  0. 


1  Internal  Variables  I 

1  Internal  Variable 

Where  Typedef  Declared 

b _ _ _ 

register  int 

Standard 

1  Calls  1 

Function 

Where  Described 

network  missiles  init 

Section  2.1.1.3.1.31.1 

Table  2.5>83:  missile  util  comm  init  Information. 
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2.5.3.24.2  inissile_util_comm_fire_missile 

This  routine  attempts  to  find  an  empty  entry  in  missile  comm.  If  one  can  be  found,  it  is 
reserved  for  the  missile  in  mptr,  and  the  missile  is  given  a  missile  ID.  An  event  ID  is 
obtained  as  well.  The  direction  and  speed  of  the  missile  is  determined,  and  the  network  is 
informed  of  a  missile  launch.  If  a  free  entry  can  not  be  found,  the  missile  is  unable  to  be 
launched. 

The  parameters  are  defined  as  follows: 

mptr  -  a  pointer  to  a  structure  of  type  MISSILE  which  contains  all  of  the 

information  that  describes  a  missile's  state  at  a  given  time. 
ammojype  -  an  index  into  the  ammunition  map  which  describes  the  type  of 

missile  launched. 
distinguished  -  the  distinguished  guise. 

other  -  the  other  guise. 

target Jd  -  the  intended  target  of  the  missile,  if  any. 

target jype  -  the  type  of  intended  target,  i.e.,  vehicle,  non-vehicle,  or  unknown. 

fuze  -  the  type  of  fuse  on  the  missile. 

tube  -  the  tube  from  which  the  missile  was  launched. 

The  internal  variables  are  described  as  follows: 
missilejd  -  used  to  find  a  free  entry  in  missile  comm. 

d_velocity  -  the  direction  and  speed  of  the  missile. 

velocity  -  the  direction  and  speed  of  the  missile  in  floats. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

mptr 

pointer  to  MISSILE 

Section  2.5.3.2 

ammo  type 

int 

Standard 

distinguished 

ObjectType 

/simnet/common/include/prof 
ocol/p  sim.h 

other 

ObjectType 

/simnet/common/include/prot 
ocol/p  sim.h 

target_id 

pointer  to  VehiclelD 

/simnet/common/include/prot 

ocol/basic.h 

int 

Standard 

fuze 

ObjectType 

/simnet/common/include/prot 
ocol/p  sim.h 

tube 

int 

Standard 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

missile  id 

register  int 

Standard 

d_velocity 

VECTOR 

/simnet/common/include/prot 
ocol/sim  types. h 

velocity 

VelocityVector 

/simnet/common/include/prot 
ocol/sim  types. h 

1  Return  values  1 

Return  Value 

Type 

Meaning 

TRUE 

int 

an  empty  entry  in 
missile  comm  can  be  found 

FALSE 

int 

an  empty  entry  cannot  be 
found. 
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Calls 

Function 

Where  Described 

event  aet  eventid 

Section  2.6.9.1.2 

vec  copy 

Section  2.6.2.59 

vec  scale 

Section  2.6.2.64 

d2f  vec  CODY 

Section  2.6. 2. 2.1 

network_send_missile_fire_ 

pkt 

Section  2.1.1.3.1.31.4 

Table  2.5-84:  missile  util  comm  fire  missile  Information. 
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2.5.3.24.3  inissile_util_comm_fly_missile 
This  routine  informs  the  world  of  where  to  fly  the  missile. 

The  parameters  are  defined  as  follows: 

mptr  -  a  pointer  to  a  structure  of  type  MISSILE  which  contains  all  of  the 

information  that  describes  a  missile's  state  at  a  given  time. 
chord  start  -  the  position  of  the  missile  at  the  beginning  i:)f  this  time  step. 

velocity  -  the  velocity  vector  of  the  missile,  including  magnitude  and 

direction. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

mptr 

pointer  to  MISSILE 

Section  2.5. 3.2 

chord_start 

VECTOR 

/simnet/common/include/prot 
ocol/sim  types. h 

velocity 

VECTOR 

/simnet/common/include/prot 
ocol/sim  Jypes.h 

Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

missile  id 

reaister  int 

Standard 

1  Calls  1 

Function 

Where  Described 

kinematics  ranoe  squared 

Section  2.5.8.10.1 

store  trai  chord 

Section  2.1.2.2.2.14.3 

map_get_tracer_from_ammo_ 

entry 

Section  2.6.11.2.9 

network_send_missile_ 

appearance 

Section  2.1.1.3.1.31.2 

missile_util_comm_stop_ 

missile 

Section  2.5.3.25.7 

Table  2.5-85:  missile_util_comm_fIy_missile  Information. 
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2.5.3.24.4  inissiIe_util_coiniii_intersected_poIy 

This  routine  is  called  by  the  CIG  to  record  the  intersection  when  the  missile  hits  a  polygon. 
If  a  missile  with  the  given  event  ID  is  found,  the  intersection  is  recorded. 

The  parameters  are  described  as  follows: 

event  id  -  the  event  ID  associated  with  the  missile. 

soiljype  -  the  type  of  soil  hit. 

intersection  jjoint  -  the  location  of  the  intersection. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

event  id 

int 

Standard 

soil  type 

int 

Standard 

intersection  point 

pointer  to  R4P3D 

dgi  stdQ.h 

Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

i 

reaister  int 

Standard 

Table  2.5-86:  missile_util_conitn_intersected_poIy  Information. 


2.5.3.24.5  missile  util  comm  intersected  model 


This  routine  is  called  by  the  QG  to  record  the  intersection  when  the  missile  hits  a  model. 
If  a  missile  with  the  given  event  ID  is  found,  the  intersection  is  recorded. 


The  parameters  arc  defined  as  follows: 


eventid 
vehiclejd 
objecttype 
intersection jpoint 
chordstart 
chord  end 


the  event  ID  associated  with  the  missile. 

-  the  vehicle  the  missile  hit 

-  the  type  of  object  hit  (hull  or  turret). 

-  the  location  of  the  intersection. 

-  the  location  of  the  beginning  of  the  chord. 

-  the  location  of  the  end  of  the  chord. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

event  id 

int 

Standard 

vehiclejd 

pointer  to  VehiclelD 

/simnet/common/include/prot 

ocol/basic.h 

i»] «]  [-M 

int 

Standard 

intersection  point 

pointer  to  R4P3D 

1 1  nil  1  Ml—— 

chord  start 

pointer  to  R4P3D 

dgi  stdg.h 

chord  end 

pointer  to  R4P3D 

dgi  stdg.h 

Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

i 

register  int 

Standard 

Table  2.5-87:  missile_util_comm_intersected_model  Information. 
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2.5.3.24.6  inissile_uti l_comin_fuze_detona te 

This  routine  is  called  by  a  fuse  when  a  detonation  occurs.  Information  about  the  detonation 
that  is  needed  by  the  network  and  CIG  is  determined  and  recorded. 

The  parameters  are  defined  as  follows: 


mptr 
targetjd 
miss _pt 
chord  start 


chordjend 

targetwjoh 


-  a  pointer  to  the  missile. 

-  the  vehicle  id  of  the  target. 

-  the  location  of  the  missile  at  detonation. 

-  the  location,  in  world  coordinates,  of  the  start  of  the  missile  chord 

which  caused  the  detonation,  relative  to  the  location  of  the 
target  at  detonation. 

-  the  location,  in  world  coordinates,  of  the  end  of  the  missile  chord 

which  caused  the  detonation,  relative  to  the  location  of  the 
target  at  detonation. 

-  a  matrix  which  transforms  from  world  coordinates  to  the  target 

vehicle's  hull  coordinates. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

mptr 

pointer  to  MISSILE 

Section  2.5. 3.2 

target_id 

pointer  to  VehiclelD 

/simnet/common/include/prot 

ocol/basic.h 

miss_pt 

VECTOR 

/simnet/common/include/prot 
ocol/sim  types,  h 

chord_start 

VECTOR 

/simnet/common/include/prot 
ocol/sim  tvpes.h 

chord_end 

VECTOR 

/simnet/common/include/prot 
ocol/sim  types. h 

targ_w_to_h 

T_MATRIX 

/simnet/common/include/prot 
ocol/sim  types. h 

internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

id 

int 

Standard 

chord_pt 

VECTOR 

/simnet/common/include/prot 
ocol/sim  types. h 

1  Calls  1 

Function 

Where  Described 

vec  mat  mul 

Section  2.6.2.56.1 

Table  2.5-88:  missile  util  comm  fuze  detonate  Information. 
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2.5.3.24.7  iiiissile_util_comm_stop_inissiIe 

This  routine  instructs  the  world  to  stop  flying  the  missile,  and  frees  the  space  in 
missile  comm,  mptr  is  a  pointer  to  a  structure  of  type  MISSILE  which  contains  all  of  the 
information  that  describes  a  missile's  state  at  a  given  time. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

mptr 

pointer  to  MISSILE 

Section  2.5.3.2 

1  Calls  1 

Function 

Where  Described 

network  send  non  impact 

Section  2.1.1.3.1.33.1 

network  stop  missile  flyout 

Section  2.1.1.3.1.31.3 

Table  2.5*89:  missile_util_coinm_stop_missile  Information. 


2.5.3.24.8  missile_util_comm_check_intersect ion 

This  routine  informs  a  missile  of  whether  it  has  intersected  with  a  polygon.  This  routine 
returns  TRUE  if  the  missile  has  intersected  with  a  polygon  and  FALSE  if  it  has  not  nptr 
is  a  pointer  to  a  structure  of  type  MISSILE  which  contains  all  of  the  information  that 
describes  a  tiussile's  state  at  a  given  time. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

mptr 

pointer  to  MISSILE 

Section  2.5.3.2 

Return  Values 

Return  Value 

Type 

Meaning 

TRUE 

int 

missile  detonated 

FALSE 

int 

missile  has  not  detonated 

Table  2.5-90:  missile  util  comm  check  intersection  Information. 
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2.5.3.243  niissile_util_comni_check_(ietonate 

This  routine*  informs  the  rest  of  the  world  of  a  missile  detonation.  This  routine  returns 
TRUE  if  the  missile  has  detonated  and  FALSE  if  it  has  not  If  detonation  has  occurred,  the 
routine  detenmines  whether  it  was  due  to  a  ground  impact,  a  vehicle  impact,  or  a  self 
detonation,  s»nd  notifies  the  network  and  the  CIG.  If  the  missile  self  detonated,  the  routine 
also  sends  ^  square  of  the  distance  from  the  explosion  to  the  target  in  the  range  field.  An 
error  message  is  printed  if  an  invalid  detonation  was  attempted,  mptr  is  a  pointer  to  a 
structure  eype  MISSILE  which  contains  all  of  the  information  that  describes  a  missile's 
state  at  a  ^vten  time. 

The  internal  variables  are  defined  as  follows: 
id  -  the  current  entry  in  missile  comm. 

ranged  -  the  square  of  the  range  from  the  firing  vehicle's  current  position  to 

the  location  of  the  detonation. 

flight  j>ath  -  a  vector  from  the  missile's  launch  position  to  the  location  of  the 

detonation. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

mptr 

pointer  to  MISSILE 

Section  2.5.3.2 

Internal  Variables 

Internal  Va^rlables 

Where  Typedef  Declared 

id 

int 

Standard 

range_2 

REAL 

/simnet/common/include/prot 
ocol/sim  types. h 

flight_path 

VECTOR 

/simnet/common/include/prot 
ocol/sim  types. h 

Return  Values 

Return  Value 

Type 

Meaning 

TRUE 

int 

missile  detonated 

FALSE 

int 

missile  has  not  detonated 

1  Calls  1 

Function 

Where  Described 

kinematics  ranae  squared 

Section  2.5.8.10.1 

vec  sub 

Section  2.6.2.65 

Section  2.1.1.3.1.70.1 

impacts  queue  effect 

Section  2.5.15.1.3 

network_semd_g  rou  nd .. 
impact 

Section  2.1.1.3.1.25.1 

vec  dot  procd 

Section  2.6.2.54 

Table  ^.5-91;  missile  util_conim_check_detonale  Information. 
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2.5.3.25  util_eval.c 

(ysimnetAelease/src/vehicle/libsrc/libmissile/utiLeval.c) 


This  file  contains  routines  which  evaluate  and  manipulate  polynomials  to  aid  in  solving 
problems  related  to  the  missiles. 

Includes: 

"sim_types.h" 

"sim_macros.h" 

"libmiss_dfn.h" 


Defines; 

MAX_DER_DEG 

Declared: 

callocO 


2.5.3.25.1  inissiIe_util_evaI_poIy 

This  routine  finds  and  returns  the  value  of  a  polynomial  of  any  order  evaluated  at  a 
particular  parameter,  param. 

are  defined  as  follows: 

-  the  degree  of  the  polynomial. 

-  an  array  containing  the  coefficients  of  the  polynomial.  The 
coefficients  should  be  stored  in  the  array  from  the  lowest 
order  coefficient  to  the  highest  order  coefficient. 

-  the  parameter  used  to  find  the  value  of  the  polynomial. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

dea 

int 

Standard 

coeff 

array  of  REAL 

/simnet/common/include/prot 
ocol/sim  types.h 

param 

REAL 

/simnet/common/include/prot 
ocol/sim  types. h 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

i 

register  int 

Standard 

result 

register  REAL 

/simnet/common/include/prot 
ocol/sim  types.h 

1  Return  Values  1 

Return  Value 

Meaning 

result 

REAL 

the  value  of  the  polynomial  at 
param 

Table  2.5-92:  inissile_util_evaI_poIy  Information. 


The  parameters 

deg 

coeff 


param 
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2.5.3.25.2  inissiIe_util_evaI_cos_coeff 

This  routine  finds  the  value  of  the  three  cosines  of  the  maximum  turn  angle  polynomials. 

They  can  be  of  any  order. 

The  parameters  are  defined  as  follows: 

mptr  -  a  pointer  to  a  structure  of  type  MISSILE  which  contains  all  of  the 

information  that  describes  a  missile's  state  at  a  given  time. 

co^  -  an  array  of  type  MAX_CX)S_CDEFF.  This  array  contains  the 

degrees  of  the  three  polynomials  used  to  c^culate  the  cosine 
of  the  maximum  allow^  turn  rate  in  the  up,  down,  and 
sideways  directions,  and  three  arrays  with  the  coefficients  of 
the  polynomials. 

param  -  the  parameter  used  to  find  the  value  of  the  polynomials. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

mptr 

pointer  to  MISSILE 

Section  2.5. 3.2 

coeff 

pointer  to  MAX  COS  COEFF 

Section  2.5.3.2 

param 

REAL 

/simnet/common/include/prot 
ocol/sim  types. h 

1  Calls  1 

Function 

Where  Described 

missile  util  eval  polv 

Section  2.5.3.26.1 

Table  2.5'93:  missile  util  eval  cos  coeff  Information. 
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inissile_utiI_eval_newton_raphson 


This  routine  uses  the  Newton-Raphson  method  to  find  the  value  of  the  parameter  which 
will  cause  the  polynomial  to  have  a  value  of  zero.  The  iteration  process  continues  until  the 
difference  between  two  consecutive  solutions  is  within  the  prescribed  tolerance,  or  until  the 
maximum  number  of  iterations  allowed  is  exceeded.  The  result  obtained  is  then  returned. 


The  parameters  are  defined  as  follows: 

deg  -  the  degree  of  the  polynomial  to  be  solved. 

coeff  -  an  array  containing  the  coefficients  of  the  polynomial.  The 

coefficients  should  be  stored  in  the  array  from  the  lowest 
order  coefficient  to  the  highest. 
seed  -  a  first  guess  to  the  solution. 

tolerance  -  the  absolute  value  of  the  maximum  difference  allowed  between  two 

consecutive  solutions  before  a  result  is  returned. 
max  jter  -  the  maximum  number  of  iterations  allowed  before  returning  a 

result. 


The  internal  variables  are  defined  as  follows: 

result  -  the  current  assumed  solution. 

delta  -  the  difference  between  the  current  and  next  guess. 

der  -  a  pointer  to  the  array  containing  the  coefficients  of  the  derivative  of 

the  polynomial. 

primary jier[MAX_DER_DEG]  -  the  preferred  array  in  which  to  store  the  derivative. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

dea 

int 

Standard 

coeff 

array  of  REAL 

/simnet/common/include/prot 
ocol/sim  types. h 

seed 

REAL 

/simnet/common/include/prot 
ocol/sim  types. h 

tolerance 

REAL 

/simnet/common/include/prot 
ocol/sim  types. h 

max  iter 

int 

Standard 

1  Internal  Variables  | 

Internal  Variable 

Type 

Where  Typedef  Declared 

i 

register  int 

Standard 

result 

register  REAL 

/simnet/common/include/prot 
ocol/sim  types. h 

delta 

register  REAL 

/simnet/common/include/prot 
ocol/sim_  types. h 

der 

pointer  to  register  REAL 

/simnet/common/include/prot 
ocol/sim  types,  h 

primary_der 

array  MAX  DER  DEG  of 

REAL 

/simnet/common/include/prot 
ocol/sim  types. h 
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Return  Values 

Return  Value 

Type 

Meaning 

result 

REAL 

the  value  of  a  parameter  that 
causes  the  polynomial  to  be 
equal  to  zero 

Calls 

Function 

Where  Described 

missile  util  eval  poly 

Section  2.5.3.26.1 

Table  2.5>94:  inissile_util_eval_newton_raphson  Information. 
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2.5.3.26  util_flyout.c 

(ysininet/release/src/vehicle/libsrc/libniissile/util_flyout.c) 

This  file  contains  the  routine  which  is  called  by  specific  missiles  to  perform  the  actual 
flyout  functions. 

Includes: 

"math.h" 

"sim_types.h" 

"sim_(tfns.h" 

"Ubmatrix.h" 

"libmiss_dfn.h" 

"Ubmiss_loc.h" 
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2.5.3.26.1  missile_util_flyout 

Given  the  missile's  allowed  turn  rate  and  desired  position  for  the  current  time  step  and  its 
last  normalized  velocity  vector,  the  new  normalize  velocity  vector  is  found  and  copied  into 
mp/r.  This  information,  along  with  the  current  speed,  is  used  to  determine  the  new  missile 
position.  This  information  is  passed  on  to  the  CIG  and  the  network,  mptr  is  a  pointer  to  a 
structure  of  type  MISSILE  which  contains  all  of  the  information  that  describes  a  missile's 
state  at  a  given  time. 

The  internal  variables  are  defined  as  follows: 

velocity  -  a  pointer  to  the  missile's  last  and  next  normalized  velocity  vector. 

orientation  -  a  pointer  to  the  missile's  orientation  matrix. 

des  traj  -  the  normalized  vector  from  the  missile's  current  position  to  its 

desired  position,  i.e.,  the  desired  trajectory. 

cosjnaxjurn  -  the  cosine  of  the  maximum  allowed  turn  angle  in  the  desired  turn 

direction. 

cos  desjurn  -  the  cosine  of  the  angle  between  the  last  missile  velocity  and  the 

desired  trajectory. 

comp  x  -  the  component  of  des  traj  in  the  X-axis  of  the  missile. 

comp  z  -  the  component  of  des  traj  in  the  Z-axis  of  the  missile. 

old _pos  -  the  location  of  the  missile  at  the  beginning  of  this  time  step. 


Parameters 


Parameter 


Internal  Variable 


velocity 


orientation 


desjraj 


cos  max  turn 


cos  des  turn 


comp_x 


comp_z 


oidjaos 


Where  Tvpedef  Declared 


Section  2.5. 3. 2 


Internal  Variables 


lERn 


reaister  int 


register  REAL 


pointer  to  register  REAL 


T  MAT  PTR 


VECTOR 


REAL 


VECTOR 


Where  Tvpedef  Declared 


Standard 


/simnet/common/include/prot 
ocol/sim  tvpes.h 


/simnet/common/include/prot 
ocol/sim  tvpes.h 


/simnet/common/include/prot 
ocol/sim  tvpes.h 


/simnet/common/include/prot 
ocol/sim  tvpes.h 


/simnet/common/include/prot 
ocol/sim  tvpes.h 


/simnet/common/include/prot 
ocol/sim  tvpes.h 


/simnet/common/include/prot 
ocol/sim  tvpes.h 


/simnet/common/include/prot 
ocol/sim  tvpes.h 


/simnet/common/include/prot 
ocol/sim  tvpes.h 


Return  Values 


TRUE 


FALSE 


Return  Values 


ieh;: 


Meanin 


The  time  step  has  been 
incremented 


This  time  step  was  the  last  one 
allowed 
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Function 


vec  sub 


vec  dotorod 


vec  CO 


vec  scale 


vec  add 


Calls 


Where  Described 


Section  2.6.2.65 


Section  2.6.2.54 


Section  2.6.2.59 


Section  2.6.2.64 


Section  2.6.2.57 


missile  util  comm  fly  missile  I  Section  2.5.3.25.3 


Table  2.5-95:  inissne_util_flyout  Information. 
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2.5.3.27  utiMnit.c 

(./simnet/release/srcA^ehicle/libsrc/Iibniissile/utiLiniLc) 

TTiis  file  contains  the  routine  called  to  perform  the  initializations  required  by  the  missiles. 

Includes: 

"libmiss_loc.h" 

2.5.3.27.1  inissiIe_utiMnit 

This  routine  calls  the  initializadon  routine  in  the  communications  module. 


1  Calls  1 

Function 

Where  Described 

missile  util  comm  init 

Section  2.5.3.25  1 

Table  2.5-96:  missile  util  init  Information. 


